Samouczek dotyczący formularzy sieci Web ASP.NET: przykłady kontrolek użytkownika

⚡ Inteligentne podsumowanie

Kontrolki użytkownika w ASP.NET Web Forms pozwalają na jednorazowe tworzenie komponentów interfejsu użytkownika wielokrotnego użytku i używanie ich na wielu stronach. Pokazuje, jak utworzyć kontrolkę użytkownika, zarejestrować ją na stronie i globalnie w pliku web.config oraz dodać właściwości publiczne.

  • ♻️ Wielokrotnego użytku Code: Użytkownik kontroluje znaczniki i logikę pakietu raz, aby móc je ponownie wykorzystać w całej aplikacji.
  • 🛠️. Utwórz kontrolę: Dodaj kontrolkę użytkownika formularza internetowego (.ascx) w programie Visual Studio i dodaj jej znaczniki.
  • 📝 Zarejestruj się na stronie: Aby używać jej na jednej stronie, należy użyć dyrektywy Register z parametrami Src, TagName i TagPrefix.
  • 🌍 Zarejestruj się globalnie: Dodaj kontrolkę w sekcji pages/controls w pliku web.config, aby używać jej na każdej stronie.
  • 🔧 Nieruchomości publiczne: Udostępnij właściwości, takie jak MinValue, aby strony mogły konfigurować zachowanie kontrolki.

Samouczek dotyczący formularzy sieci Web ASP.NET: przykłady kontrolek użytkownika

W ASP.Net możliwe jest tworzenie kodu wielokrotnego użytku. Kod wielokrotnego użytku można wykorzystać w wielu miejscach, bez konieczności ponownego pisania kodu.

Możliwość ponownego użycia kodu pomaga skrócić czas poświęcany przez programistę na napisanie kodu. Można go napisać raz i wykorzystać ponownie w wielu miejscach.

Utwórz kontrolę użytkownika w ASP.Net

ASP.Net umożliwia tworzenie kontrolek internetowych. Kontrolki te zawierają kod, który można ponownie wykorzystać. Można go używać w całej aplikacji, zgodnie z wymaganiami.

Przyjrzyjmy się przykładowi tworzenia kontrolki użytkownika w środowisku ASP.Net.

W naszym przykładzie:

  • Stworzymy kontrolę sieciową.
  • Zostanie on użyty do utworzenia komponentu nagłówka.
  • Będzie zawierał poniższy tekst: „Guru99 samouczków” i „Ten samouczek dotyczy ASP.Net”.

Pracujmy z naszą obecną aplikacją internetową stworzoną we wcześniejszych sekcjach. Wykonajmy poniższe kroki, aby utworzyć kontrolkę użytkownika sieci Web.

Krok 1) Pierwszym krokiem jest utworzenie kontrolki użytkownika sieci Web i dodanie jej do naszego rozwiązania Visual Studio.

Utwórz kontrolę użytkownika w ASP.Net

  1. Przejdź do Eksploratora rozwiązań w programie Visual Studio i kliknij prawym przyciskiem myszy rozwiązanie DemoApplication.
  2. Wybierz pozycję menu Dodaj->Nowy element.

Krok 2) W następnym kroku musimy wybrać opcję utworzenia kontrolki użytkownika internetowego.

Utwórz kontrolę użytkownika w ASP.Net

  1. W oknie dialogowym projektu możemy zobaczyć różne opcje tworzenia różnych typów komponentów. Kliknij opcję „Web” po lewej stronie.
  2. Po kliknięciu opcji „Sieć” pojawi się opcja „Kontrola użytkownika formularzy internetowych”. Kliknij tę opcję.
  3. Następnie nadajemy nazwę Kontroli sieciowej: „Guru99Control”.
  4. Na koniec kliknij przycisk „Dodaj”, aby program Visual Studio dodał kontrolkę użytkownika internetowego do naszego rozwiązania.

Zobaczysz wtedy „Guru„99Control” dodano do rozwiązania.

Utwórz kontrolę użytkownika w ASP.Net

Krok 3) Czas dodać niestandardowy kod do kontrolki użytkownika w sieci. Nasz kod będzie oparty na czystej składni HTML. Dodaj następujący kod do kontrolki „GuruPlik '99Control.ascx.

Utwórz kontrolę użytkownika w ASP.Net

<table>
	<tr>
	  <td>Guru99 Tutorials</td>
	</tr>

	<tr>
	  <td> This Tutorial is for</td>
	</tr>
</table>

Code Wyjaśnienie:-

  1. W naszym pliku Web Control najpierw tworzymy element tabeli. Będzie on służył do przechowywania 2 wierszy tekstu, które będą wyświetlać „Guru99 samouczków” i „Ten samouczek dotyczy ASP.Net”.
  2. Następnie definiujemy pierwszy wiersz tabeli i wpisujemy tekst jako „Guru99 samouczków.”
  3. Następnie definiujemy drugi wiersz tabeli i umieszczamy tekst „Ten samouczek jest przeznaczony dla ASP.Net”.

UWAGA: Teraz nie możemy wykonać tego kodu i wyświetlić wyników. Jedynym sposobem, aby sprawdzić, czy to działa, jest dołączenie go do naszej aplikacji (plik aspx). Zobaczymy to w następnym temacie.

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

W poprzedniej sekcji pokazaliśmy, jak utworzyć niestandardową kontrolkę internetową. Można jej użyć do wyświetlenia następujących dwóch wierszy w formularzu internetowym:

  • "Guru99 samouczków”
  • „Ten samouczek jest przeznaczony dla ASP.Net.”

Po utworzeniu niestandardowej kontrolki musimy jej użyć w naszej aplikacji internetowej. Pierwszym krokiem jest zarejestrowanie komponentu w aplikacji (Demo.aspx). Jest to warunek konieczny do użycia dowolnej niestandardowej kontrolki internetowej w aplikacji ASP.Net.

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

Przyjrzyjmy się, jak możemy to osiągnąć. Poniższe kroki stanowią kontynuację poprzedniej sekcji, w której utworzyliśmy naszą niestandardową kontrolkę. W tej sekcji użyjemy tej kontrolki w naszym Demo.aspx formularz internetowy. Najpierw zarejestrujemy nasz niestandardowy „kontroler” w pliku Demo.aspx.

Krok 1) Upewnij się, że pracujesz na pliku demo.aspx. To właśnie w tym pliku zostanie zarejestrowana kontrolka użytkownika sieci Web. Można to zrobić, klikając dwukrotnie plik demo.aspx w Eksploratorze rozwiązań rozwiązania .NET.

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

Po dwukrotnym kliknięciu formularza prawdopodobnie zobaczysz poniższy kod. Jest to domyślny kod dodawany przez program Visual Studio podczas dodawania formularza internetowego do projektu ASP.Net. Domyślny kod składa się z kroków niezbędnych do uruchomienia formularza jako formularza internetowego ASP.Net w przeglądarce.

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

Krok 2) Teraz dodajmy kod rejestrujący kontrolkę użytkownika. Poniższy zrzut ekranu pokazuje rejestrację kontrolki użytkownika dodaną do powyższego podstawowego kodu.

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Demo.aspx.cs" Inherits="DemoApplication.Demo" %>
<%@ Register Src="~/Guru99Control.ascx" TagName="WebControl" TagPrefix="TWebControl" %>

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
	<title></title>
</head>
<body>
	<form id="form1" runat="server">
		<TWebControl:WebControl ID="Header" runat="server" />
	</form>
</body>
</html>

Code Wyjaśnienie:-

  1. Pierwszym krokiem jest rejestracja kontrolki użytkownika internetowego. Obejmuje to poniższe podstawowe parametry:
    1. Słowo kluczowe „Register” służy do rejestrowania kontroli użytkownika sieciowego.
    2. Parametr Src służy do zdefiniowania nazwy kontrolki, która w naszym przypadku to Guru99Control.ascx.
    3. TagName i TagPrefix to indywidualne nazwy nadawane kontrolce. Robi się to, aby można było się do nich odwoływać na stronach HTML, tak jak do zwykłej kontrolki HTML.
  2. Następnie odwołujemy się do naszej kontrolki użytkownika za pomocą TagPrefix:TagName, która została przypisana wcześniej. TagPrefix:TagName wskazuje, że chcemy użyć naszej niestandardowej kontrolki internetowej. Po przetworzeniu strony przez serwer WWW widać, że użyliśmy znacznika TWebControl:WebControl. Następnie zostanie przetworzony znacznik „Guru99Control' odpowiednio.
    1. Opcjonalny identyfikator jest nadawany kontrolce „Nagłówek”. Nadawanie identyfikatora kontrolce HTML jest zazwyczaj dobrą praktyką.
    2. Atrybut runat=”server” zapewnia, że ​​kontrolka będzie działać na serwerze WWW. Dla wszystkich kontrolek ASP.Net jest to atrybut domyślny. Wszystkie kontrolki ASP.Net (w tym kontrolki niestandardowe) muszą działać na serwerze. Ich dane wyjściowe są następnie przesyłane z serwera do klienta i odpowiednio wyświetlane w przeglądarce.

Gdy powyższy kod jest ustawiony, a projekt jest wykonywany przy użyciu visual Studio, otrzymasz poniższe dane wyjściowe.

Wynik:-

Rejestrowanie kontrolek użytkownika w formularzu internetowym ASP.NET

Komunikat wyjściowy wyświetlany w przeglądarce informuje, że kontrolka użytkownika została pomyślnie wykonana.

Rejestrowanie kontrolek ASP.Net globalnie w pliku konfiguracyjnym web.config

Czasami może zaistnieć potrzeba użycia kontrolek użytkownika na wielu stronach w aplikacji .NET. W tym momencie nie chcemy rejestrować kontrolek użytkownika na każdej stronie ASP.NET.

  • W .Net możesz dokonać rejestracji w pliku 'web.config'.
  • Plik web.config to wspólny plik konfiguracyjny używany przez wszystkie strony internetowe w projekcie .Net.
  • Zawiera niezbędne szczegóły konfiguracji dla projektu internetowego ASP.Net. Na przykład jedną z typowych konfiguracji w pliku web.config jest docelowy parametr struktury.
  • Parametr ten służy do identyfikacji wersji frameworku .Net używanej przez aplikację.

Poniżej znajduje się migawka domyślnego kodu w pliku web.config. Podświetlona część to docelowa część szkieletu.

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

Zobaczmy, jak możemy zarejestrować nasze Guru99Control w pliku web.config.

Krok 1) Otwórz plik web.config w Eksploratorze rozwiązań, klikając go dwukrotnie.

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

Po otwarciu pliku web.config możesz zobaczyć poniższą konfigurację. Plik 'web.config' jest automatycznie dodawany przez program Visual Studio podczas tworzenia projektu. Jest to podstawowa konfiguracja wymagana do prawidłowego działania projektu ASP.Net.

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

Krok 2) Zarejestrujmy teraz nasz komponent w pliku web.config. W tym celu musimy dodać poniższe linie.

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

<configuration>
	<system.web>
	 <compilation debug="true" targetFramework="4.5" />
	<pages>
		<controls>
		 <add tagPrefix="TWebControl" src="~/Guru99Control.ascx" tagName="WebControl" />
		</controls>
	</pages>
	</system.web>
</configuration>

Rejestracja składa się z następujących podkroków:

  1. Dodaj tag o nazwie . Oznacza to, że cała konfiguracja kontrolek będzie miała zastosowanie do wszystkich stron ASP.Net w rozwiązaniu.
  2. The tag oznacza, że ​​dodajesz konfigurację dla kontrolki użytkownika.
  3. Następnie rejestrujemy kontrolkę użytkownika z dodatkowym tagiem. Pozostałe parametry tagPrefix, tagName i src pozostają takie same jak poprzednio.

Krok 3) Pamiętaj, aby przejść na stronę „demo.aspx” i usunąć wiersze dotyczące kontrolki, która miała zarejestrowaną Guru99. Jeśli nie wykonasz tego kroku, to „GuruPlik '99Control.ascx' będzie wykonywany z pliku 'demo.aspx' zamiast z pliku 'web.config'.

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Demo.aspx.cs" Inherits="DemoApplication.Demo" %>

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
	<head runat="server">
	  <title></title>
	</head>
<body>
	<form id="form1" runat="server">
	  <TWebControl:WebControl ID="Header" runat="server" />
	</form>
</body>
</html>

Po skonfigurowaniu powyższego kodu i uruchomieniu projektu za pomocą programu Visual Studio otrzymasz poniższy wynik.

Wynik:-

Rejestrowanie kontrolek ASP.Net globalnie w pliku web.config

Komunikat wyjściowy pokazuje, że kontrola użytkownika WWW została pomyślnie wykonana.

Dodawanie właściwości publicznych do kontrolki internetowej

Właściwość to para klucz-wartość powiązana z dowolną kontrolką. Weźmy na przykład prosty Tag HTML. Poniżej znajduje się zrzut ekranu pokazujący wygląd tagu.

Dodawanie właściwości publicznych do kontrolki internetowej

<html>
<body>
	<div style="color:#0000FF">

		Demo Form

	</div>
</body>
</html>

Tag 'div' służy do tworzenia sekcji w dokumencie HTML. Tag 'div' ma właściwość zwaną style property. Może być ona używana do nadawania innego stylu tekstowi wyświetlanemu w tagu div. Normalnie kod tagu div jest pokazany poniżej.

<div style="color:#0000FF">

Zatem atrybut koloru to nic innego jak para klucz-wartość, która dostarcza więcej informacji o samym tagu. W powyższym przypadku nazwa klucza to „styl”, a wartość klucza to „kolor:#0000FF”.

Podobnie w przypadku kontrolek użytkownika można utworzyć własne właściwości opisujące formant.

Weźmy prosty przykład i rozbudujmy go na naszym 'GuruKontrolka 99Control została utworzona we wcześniejszych sekcjach. W naszym przykładzie dodamy prostą właściwość całkowitą o nazwie MinValue. Wartość ta będzie reprezentować minimalną liczbę znaków w tekście wyświetlanym w kontrolce użytkownika.

Wykonajmy poniższe kroki, aby to wdrożyć.

Krok 1) Otwórz GuruPlik 99Control.ascx. Dodaj kod do dodawania właściwości MinValue.

Dodawanie właściwości publicznych do kontrolki internetowej

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Demo.aspx.cs" Inherits="DemoApplication.Demo" %>

	<script runat="server">
	  public int MinValue = 0;
	</script>

<table>
	<tr>
	  <td>Guru99 Tutorials</td>
	</tr>

	<tr>
	  <td> This Tutorial is for</td>
	</tr>
</table>

Code Wyjaśnienie:-

Atrybut skryptu runat=”server” służy do wskazania, że ​​dodajemy kod specyficzny dla platformy .NET i że musi on zostać uruchomiony na serwerze WWW. Jest to wymagane do przetworzenia dowolnej właściwości dodanej do kontrolki użytkownika. Następnie dodajemy właściwość MinValue i nadajemy jej wartość domyślną 0.

Krok 2) Teraz odwołajmy się do tej właściwości w naszym pliku demo.aspx. Jedyne, co teraz robimy, to po prostu odwołujemy się do właściwości MinValue i przypisujemy nową wartość 100.

Dodawanie właściwości publicznych do kontrolki internetowej

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
	<head runat="server">
	  <title></title>
	</head>
<body>
	<form id="form1" runat="server">
	  <TWebControl:WebControl ID="Header" runat="server" MinValue="100" />
	</form>
</body>
</html>

UWAGA: Po uruchomieniu tego kodu nie wyświetli się żaden wynik. Dzieje się tak, ponieważ długość wyniku mieści się w limicie 100 znaków.

FAQ

Tak. Asystenci AI mogą generować znaczniki .ascx, kod źródłowy i dyrektywę Register na podstawie opisu komponentu wielokrotnego użytku. RevSprawdź wygenerowane wartości TagPrefix, TagName i Src, aby upewnić się, że odpowiadają Twojemu projektowi.

Częściowo. Sztuczna inteligencja może pomóc w tłumaczeniu kontrolki użytkownika .ascx na komponent ASP.NET Core Razor lub częściowy widok i sygnalizować różnice w modelu. Migracje nadal wymagają ręcznego testowania, ponieważ frameworki inaczej obsługują stan i zdarzenia.

Kontrolka użytkownika (.ascx) jest budowana z istniejących kontrolek i jest łatwa do utworzenia, ale powiązana z jednym projektem. Kontrolka niestandardowa jest kompilowana do pliku DLL, co jest trudniejsze do zbudowania, ale możliwe do wielokrotnego wykorzystania w wielu projektach i dostępne w zestawie narzędzi.

Zarejestruj się na pojedynczej stronie, jeśli tylko ta strona korzysta z kontrolki. Zarejestruj się w pliku web.config, jeśli kontrolka jest używana na wielu stronach, aby uniknąć powtarzania dyrektywy Register na każdej stronie.

Podsumuj ten post następująco: