W tym dodatku zostaną przedstawione właściwości i metody wszystkich elementów sterujących wykorzystywanych w ASP.NET — elementów sterujących HTML, internetowych elementów sterujących oraz elementów sterujących służących do kontroli poprawności. Więcej szczegółowych informacji na temat tych wszystkich elementów sterujących można znaleźć w dokumentacji .NET SDK.
Wszystkie elementy sterujące przedstawione w tym dodatku dziedziczą właściwości po klasie System.Web.UI.Control, przedstawionej w tabeli B.1.
Tabela B.1. Właściwości klasy Control dziedziczone przez wszystkie elementy sterujące ASP.NET wykonywane na serwerze.
Właściwość
Opis
ClientID
Identyfikator elementu sterującego wygenerowany dla niego przez ASP.NET.
Controls
Zwraca obiekt klasy ControlCollection reprezentujący wszystkie podrzędne elementy sterujące danego elementu.
EnableViewState
Określa czy element sterujący powinien zapamiętywać swój stan (tzw. widok stanu) oraz stan wszystkich elementów podrzędnych.
ID
Określa identyfikator danego elementu sterującego. Właściwość ta musi zostać określona, by można było korzystać z danego elementu sterującego w programie i obsługiwać generowane przez niego zdarzenia.
NamingContainer
Zwraca odwołanie do nadrzędnego elementu sterującego, który określił przestrzeń nazw używaną przez dany element sterujący.
Page
Zwraca obiekt klasy Page reprezentujący stronę na której jest umieszczony dany element sterujący.
Parent
Zwraca nadrzędny element sterujący w hierarchii elementów sterujących interfejsu użytkownika.
Site
Zwraca informacje na temat witryny na jakiej wyświetlany jest dany element sterujący.
TemplateSourceDirectory
Określa katalog wirtualny w którym jest przechowywana strona zawierająca dany element sterujący.
UniqueID
Określa unikalny, hierarchiczny identyfikator elementu sterującego.
Różni się ona od właściwości ID, gdyż określa położenie danego obiektu w hierarchii elementów sterujących.
Visible
Określa czy dany element sterujący powinien być widoczny na stronie.
W tabeli B.2 zostały przedstawione metody dziedziczone przez wszystkie elementy sterujące ASP.NET dziedziczone po klasie Control.
Tabela B.2. Metody klasy Control dziedziczone przez wszystkie elementy sterujące ASP.NET.
Metoda
DataBind
Wiąże dane z określonym elementem sterującym.
Dispose
Wykonuje wszelkie ostateczne czynności porządkowe przed usunięciem elementu sterującego.
FindControl(łańcuch)
Przeszukuje dany element sterujący w poszukiwaniu elementu podrzędnego określonego za pomocą podanego łańcucha znaków. Zwraca obiekt klasy Control.
HasControls
Określa czy dany element sterujący ma jakieś elementy podrzędne.
RenderControl(pisarz)
Generuje zawartość elementu sterującego i przekazuje ją do obiektu klasy HtmlTextWriter określonego za pomocą argumentu pisarz.
SetRenderMethodDelegate (metoda)
Zapisuje w nadrzędnym elemencie sterującym delegata procedury obsługi zdarzenia służącego do wyświetlenia danego elementu sterującego oraz jego zawartości. Argumentem wywołania tej metody jest obiekt klasy RenderMethod.
W tabeli B.3 przedstawione zostały zdarzenia klasy Control, dziedziczone przez wszystkie elementy sterujące ASP.NET.
Zdarzenie
DataBinding
Zdarzenie zachodzi gdy z elementem sterującym są wiązane dane.
Disposed
Zdarzenie zachodzi gdy element sterujący jest usuwany z pamięci.
Init
Zdarzenie zachodzi podczas inicjalizacji elementu sterującego (konkretnie rzecz biorąc podczas pierwszego etapu inicjalizacji).
Load
Zdarzenie zachodzi gdy element sterujący jest pobierany przez obiekt Page.
PreRender
Zdarzenie zachodzi przed wyświetleniem elementu sterującego.
Unload
W tej części dodatku zostały przedstawione szczegółowe informacje na temat wszystkich elementów sterujących HTML dostępnych w środowisku formularzy internetowych. Pamiętasz zapewne, że każdy element HTML można przekształcić w element sterujący HTML; wystarczy dodać do niego atrybut runat="server". W tej części rozdziału znajdziesz szczegółowe informacje na temat wszystkich predefiniowanych elementów sterujących HTML. Wszystkie elementy które nie są predefiniowane dysponują tym samym zbiorem wspólnych właściwości, metod i zdarzeń, które zostały opisane w poniższym podrozdziale pt.: „Wspólne właściwości wszystkich elementów sterujących HTML”.
Tabela B.4 przedstawia właściwości dziedziczone po klasie System.Web.UI.HtmlControls.HtmlControl przez wszystkie elementy sterujące HTML.
Tabela B.4. Wspólne właściwości elementów sterujących HTML.
Attributes
Pobiera wszystkie pary nazwa-wartość reprezentujące atrybuty znacznika.
Disabled
Określa czy na stronie WWW dany element sterujący ma być przeznaczony wyłącznie do odczytu.
Style
Zwraca właściwości kaskadowych arkuszy stylów dla danego elementu.
TagName
Zwraca nazwę elementu sterującego.
W tabeli B.5 zostały przedstawione właściwości dostępne we wszystkich elementach sterujących HTML służących do wprowadzania informacji (takich jak HtmlInputText, HtmlInputCheckBox, i tak dalej) dziedziczone po klasie System.Web.UI.HtmlControls.HtmlInputControl.
Tabela B.5. Wspólne właściwości elementów sterujących HTML służących do wprowadzania danych.
Name
Określa unikalną nazwę danego elementu sterującego.
Value
Określa zawartość danego elementu sterującego.
Type
Zwraca typ danego elementu sterującego.
W tabeli B.6 zostały przedstawione właściwości dostępne we wszystkich „kontenerowych” elementach sterujących HTML (takich jak HtmlTable, HtmlForm, itp.) dziedziczone po klasie System.Web.UI.HtmlControls.HtmlContainerControl.
Tabe...
grzegorj