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.
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.
- Przejdź do Eksploratora rozwiązań w programie Visual Studio i kliknij prawym przyciskiem myszy rozwiązanie DemoApplication.
- Wybierz pozycję menu Dodaj->Nowy element.
Krok 2) W następnym kroku musimy wybrać opcję utworzenia kontrolki użytkownika internetowego.
- W oknie dialogowym projektu możemy zobaczyć różne opcje tworzenia różnych typów komponentów. Kliknij opcję „Web” po lewej stronie.
- Po kliknięciu opcji „Sieć” pojawi się opcja „Kontrola użytkownika formularzy internetowych”. Kliknij tę opcję.
- Następnie nadajemy nazwę Kontroli sieciowej: „Guru99Control”.
- 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.
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.
<table> <tr> <td>Guru99 Tutorials</td> </tr> <tr> <td> This Tutorial is for</td> </tr> </table>
Code Wyjaśnienie:-
- 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”.
- Następnie definiujemy pierwszy wiersz tabeli i wpisujemy tekst jako „Guru99 samouczków.”
- 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.
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.
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.
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.
<%@ 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:-
- Pierwszym krokiem jest rejestracja kontrolki użytkownika internetowego. Obejmuje to poniższe podstawowe parametry:
- Słowo kluczowe „Register” służy do rejestrowania kontroli użytkownika sieciowego.
- Parametr Src służy do zdefiniowania nazwy kontrolki, która w naszym przypadku to Guru99Control.ascx.
- 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.
- 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.
- Opcjonalny identyfikator jest nadawany kontrolce „Nagłówek”. Nadawanie identyfikatora kontrolce HTML jest zazwyczaj dobrą praktyką.
- 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:-
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.
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.
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.
Krok 2) Zarejestrujmy teraz nasz komponent w pliku web.config. W tym celu musimy dodać poniższe linie.
<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:
- Dodaj tag o nazwie . Oznacza to, że cała konfiguracja kontrolek będzie miała zastosowanie do wszystkich stron ASP.Net w rozwiązaniu.
- The tag oznacza, że dodajesz konfigurację dla kontrolki użytkownika.
- 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'.
<%@ 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:-
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.
<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.
<%@ 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.
<!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.



















