Dodatek B
Elementy sterujące ASP.NET: Właściwości i metody

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	Opis
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	Opis
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	Zdarzenie zachodzi gdy element sterujący jest usuwany z pamięci.

Elementy sterujące HTML

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”.

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.

Właściwość	Opis
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.

Właściwość	Opis
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.

Tabela B.6. Wspólne właściwości „kontenerowych” elementów sterujących HTML.

Właściwość	Opis
InnerHtml	Określa zawartość (kod HTML) zapisaną pomiędzy otwierającym i zamykającym znacznikiem danego elementu sterującego.
InnerText	--> Określa tekst[Author:p8R] zapisany pomiędzy otwierającym i zamykającym znacznikiem elementu sterującego. Wszelkie znaki specjalne HTML występujące w zawartości tej właściwości są odpowiednio kodowane (do postaci odpowiednich symboli HTML).

Elementy sterujące HTML

W tej części rozdziału zostały opisane właściwości i metody wszystkich predefiniowanych elementów sterujących HTML. Należy pamiętać iż wszystkie te elementy posiadają także dodatkowe właściwości dziedziczone po swoich klasach bazowych (opisanych w poprzednim podrozdziale).

HtmlAnchor

Te elementy sterujące reprezentują odnośniki lub połączenia występujące na stronach WWW. Właściwości i zdarzenia klasy HtmlAnchor zostały przedstawione w tabeli B.7. Poniżej została przedstawiona składnia zapisu tych elementów sterujących:

<a href="..." ... runat="server">...</a>

Tabela B.7. Właściwości i zdarzenia elementu sterującego HtmlAnchor.

Właściwość	Opis
Href	Określa docelowy adres URL.
Name	Określa nazwę zakładki określoną w danym elemencie sterującym.
Target	Określa okno przeglądarki w jakim należy wyświetlić docelową stronę WWW.
Title	Określa tytuł docelowej strony WWW wyświetlany przez przeglądarkę.
Zdarzenie	Opis
ServerClick	Zachodzi gdy użytkownik kliknie element sterujący

HtmlButton

Elementy sterujące HtmlButton reprezentują przyciski (dostępne wyłącznie w przeglądarkach obsługujących standard HTML 4.0). Tabela B.9 przedstawia zdarzenie generowane przez elementy sterujące HtmlButton. Poniżej została przedstawiona składnia zapisu tych elementów sterujących:

<button ... runat="server">

Tabela B.8. Zdarzenie generowane przez elementy sterujące HtmlButton.

Zdarzenie	Opis
ServerClick	Zachodzi gdy użytkownik kliknie element sterujący.

HtmlForm

Elementy sterujące HtmlForm reprezentują formularze HTML. Ich właściwości zostały przedstawione w tabeli B.9. Poniższy przykład przedstawiona składnia zapisu tych elementów sterujących:

<form ... runat="server">

Tabela B.9. Właściwości elementów sterujących HtmlForm.

Właściwość	Opis
Action	Określa adres URL strony obsługującej i przetwarzającej informacje podane w formularzu po ich przesłaniu na serwer.
EncType	Sposób kodowania wykorzystywany przez przeglądarkę do przesłania informacji podanych w formularzu (na przykład: "text/plain" lub "image/jpeg".
Method	Określa w jaki sposób informacje wpisane w formularzu zostaną przesłane na serwer, na przykład "Get" lub "Post".
Name	Określa nazwę formularza.
Target	Określa docelowe okno przeglądarki w jakim zostaną wyświetlone wyniki przetworzenia formularza.

HtmlImage

Te elementy sterujące reprezentują obrazy wyświetlane na stronach WWW. Tabela B.10. przedstawia właściwości tych elementów sterujących, a poniższy przykład prezentuje składnię ich zapisu:

<img ... runat="server">

Tabela B.10. Właściwości elementów sterujących HtmlImage.

Właściwość	Opis
Align	Wyrównanie obrazu względem pozostałych elementów strony WWW.
Alt	Alternatywny tekst określający tytuł obrazu.
Border	Grubość ramki wyświetlanej wokół obrazu.
Height	Wysokość obrazu.
Src	Plik zawierający obraz.
Width	Szerokość obrazu.

HtmlInputButton

Elementy sterujące HtmlInputButton reprezentują przyciski wyświetlane na formularzach HTML. Tabela B.11 zawiera informacje na temat zdarzenia generowanego przez te elementy sterujące. Poniżej została przedstawiona składnia zapisu tych elementów sterujących:

<input type="button" ... runat="server">

Tabela B.11. Zdarzenie elementów sterujących HtmlInputButton.

Zdarzenie	Opis
ServerClick	Zachodzi gdy użytkownik kliknie element sterujący.

HtmlInputCheckBox

Elementy sterujące HtmlInputCheckBox reprezentują pola wyboru. Tabela B.12 przedstawia właściwości i zdarzenia tych elementów sterujących. Poniżej została przedstawiona składnia zapisu tych elementów sterujących:

<input type="checkbox" ... runat="server">

Tabela B.12. Właściwości i zdarzenia elementów sterujących HtmlInputCheckBox.

Właściwość	Opis
Checked	Określa czy dany element sterujący został zaznaczony.
Zdarzenie	Opis
ServerChange	Zdarzenie zachodzi po przesłaniu formularza, jeśli bieżący stan danego elementu sterującego od stanu wcześniejszego.

HtmlInputControl

Klasa HtmlInputControl reprezentuje ogólny element sterujący wykorzystywany w formularzach HTML. Właściwości elementów sterujących tej klasy zostały przedstawione w tabeli B.13. Poniżej została przedstawiona składnia zapisu tego elementu sterującego:

<input ... runat="server">

Tabela B.13. Właściwości elementów sterujących HtmlInputControl.

Właściwość	Opis
Name	Unikalna nazwa elementu sterującego.
Type	Określa typ danego elementu sterującego. Właściwość ta może przybierać następujące wartości: "text", "password", "checkbox", "radio", "button", "submit", "reset", "file", "hidden" bądź "image". Ta właściwość jest przeznaczona wyłącznie do odczytu.
Value	Zawartość elementu sterującego.

HtmlInputFile

Elementy sterujące HtmlInputFile reprezentują elementy formularzy umożliwiające przesyłanie plików na serwer. Właściwości tych elementów sterujących przedstawia tabela B.14, a poniższy przykład — składnię ich zapisu:

<input type="file" ... runat="server">

Tabela B.14 Właściwości i zdarzenia elementów sterujących HtmlInputFile.

Właściwość	Opis
Accept	Określa listę typów MIME plików, które można przesyłać na serwer.
MaxLength	Określa maksymalną wielkość pliku jaki można przesłać na serwer.
PostedFile	Umożliwia dostęp do przesłanego pliku; właściwość ta zwraca obiekt klasy HttpPostedFile.
Size	Określa szerokość pola tekstowego, w którym można wpisywać ścieżkę dostępu do pliku, który ma zostać przesłany na serwer.

HtmlInputHidden

Elementy sterujące tej klasy reprezentują ukryte pola formularzy. Zdarzenia generowane przez te elementy sterujące przedstawia tabela B.15, a poniższy przykład — składnię ich zapisu:

<input type="hidden" ... runat="server">

Tabela B.15. Właściwości i zdarzenia elementów sterujących HtmlInputHidden.

Zdarzenie	Opis
ServerChange	Zdarzenie zachodzi gdy przesłana zawartość tego elementu sterującego różni się od jego poprzedniej zawartości.

HtmlInputImage

Elementy sterujące HtmlInputImage reprezentują przyciski graficzne używane w formularzach HTML. Właściwości i zdarzenia tych elementów sterujących przedstawia tabela B.16, a poniższy przykład — składnię ich zapisu:

<input type="image" ... runat="server">

Tabela B.16. Właściwości i zdarzenia elementów sterujących HtmlInputImage.

Właściwość	Opis
Align	Określa wyrównanie obrazu względem pozostałych elementów na stronie.
Alt	Określa tekst alternatywny wyświetlany na stronie.
Border	Określa grubość ramki wyświetlanej wokół obrazu.
Src	Określa położenie pliku w jaki jest zapisany obraz.
Zdarzenie	Opis
ServerClick	Zachodzi gdy użytkownik kliknie element sterujący.

HtmlInputRadio

Elementy sterujące HtmlInputRadio reprezentują przyciski opcji wyświetlane na formularzach HTML. Jedyną właściwość tych elementów sterujących przedstawia tabela B.17, a poniższy przykład — składnię ich zapisu:

<input type="radio" ... runat="server">

Tabela B.17. Właściwości i zdarzenia elementów sterujących HtmlInputRadio.

Zdarzenie	Opis
Checked	Określa czy element sterujący jest zaznaczony.

HtmlInputText

Elementy sterujące HtmlInputText reprezentują zwyczajne pola tekstowe. Właściwości tych elementów sterujących przedstawia tabela B.18, a poniższy przykład — składnię ich zapisu:

<input type="text" ... runat="server">

Tabela B.18. Właściwości i zdarzenia elementów sterujących HtmlInputText.

Właściwość	Opis
MaxLength	Określa maksymalną długość łańcucha znaków jaki można wpisać w danym elemencie sterującym.
Size	Określa szerokość pola wyrażoną jako ilość znaków jakie będą w nim jednocześnie widoczne.
Value	Zawartość elementu sterującego.

HtmlSelect

Elementy sterujące HtmlSelect reprezentują listy lub listy rozwijalne zawierające opcje, które użytkownik może wybierać. Właściwości i zdarzenia tych elementów sterujących przedstawia tabela B.19, a poniższy przykład — składnię ich zapisu:

<select ... runat="server">

Tabela B.19. Właściwości i zdarzenia elementów sterujących HtmlSelect.

Właściwość	Opis
DataMember	Nazwa tabeli lub widoku jakiego należy użyć (właściwość jest wykorzystywana jeśli właściwości DataSource został przypisany jakiś obiekt klasy DataSet).
DataSource	Źródło danych, jakie zostanie użyte do wypełnienia tego elementu sterującego.
DataTextField	Określa pole źródła danych, którego wartości będą wyświetlane jako nazwy opcji listy.
DataValueField	Określa pole źródła danych, którego wartości zostaną użyte jako wartości poszczególnych opcji listy.
InnerHtml	Kod HTML zapisany pomiędzy otwierającym i zamykającym znacznikiem danego elementu sterującego.
InnerText	Tekst zapisany pomiędzy otwierającym i zamykającym znacznikiem tego elementu sterującego.
Items	Zwraca wszystkie opcje dostępne na danej liście; właściwość ta zwraca obiekt klasy ListItemCollection.
Multiple	Określa czy na liście można jednocześnie zaznaczyć większą ilość opcji (w tym celu należy się posłużyć klawiszami Ctrl lub Shift).
SelectedIndex	Indeks aktualnie wybranej opcji listy. Jeśli na liście zostało wybranych kilka opcji, to właściwość ta będzie zawierać indeks pierwszej z nich.
Size	Liczba określająca ile opcji będzie widocznych na liście.
Value	Wartość aktualnie wybranej opcji.
Zdarzenie	Opis
ServerChange	Zdarzenie zachodzi gdy wybrany element listy przesłany na serwer, nie jest tym samym elementem, który został wybrany wcześniej.

HtmlTable, HtmlTableCell oraz HtmlTableRow

Elementy sterujące HtmlTable, HtmlTableCell oraz HtmlTableRow reprezentują tabele, ich komórki i wiersze. W tabeli B.20 zostały przedstawione właściwości, którymi dysponują wszystkie te elementy sterujące.

Tabela B.20. Właściwości dostępne w elementach sterujących HtmlTable, HtmlTableRow oraz HtmlTableCell.

Właściwość	Opis
Align	Wyrównanie elementu sterującego w stosunku do pozostałych elementów strony WWW.
BGColor	Kolor tła danego elementu sterującego.
BorderColor	Kolor obramowania wyświetlanego wokół danego elementu sterującego.
Height	Wysokość danego elementu sterującego.

Właściwości elementów sterujących HtmlTable przedstawia tabela B.21, a na poniższym przykładzie pokazana została składnia ich zapisu:

<table ... runat="server">

Tabela B.21. Właściwości elementów sterujących HtmlTable.

Właściwość	Opis
Border	Szerokość obramowania wyświetlanego wokół tabeli oraz pomiędzy jej komórkami.
CellPadding	Wielkość obszaru pomiędzy zawartością komórki oraz jej krawędziami.
CellSpacing	Odległość pomiędzy komórkami.
InnerHtml	Kod HTML zapisany pomiędzy otwierającym i zamykającym znacznikiem danego elementu sterującego.
InnerText	Sam tekst zapisany pomiędzy otwierającym i zamykającym znacznikiem danego elementu sterującego.
Rows	Zwraca obiekt klasy HtmlRowCollection reprezentujący wszystkie wiersze tabeli.

Tabela B.22 przedstawia właściwości elementów sterujących HtmlTableCell, a na poniższym przykładzie została pokazana składnia ich zapisu:

<td ... runat="server">

Tabela B.22. Właściwości i zdarzenia elementów sterujących HtmlTableCell.

Właściwość	Opis
ColSpan	Ilość kolumn które obejmuje dana komórka.
NoWrap	Określa czy tekst wyświetlany wewnątrz danej komórki może być zawijany.
RowSpan	Ilość wierszy które obejmuje dana komórka.
VAlign	Wyrównanie zawartości komórki w pionie.
Width	Szerokość danej komórki tabeli.

Tabela B.23 przedstawia właściwości elementów sterujących HtmlTableRow, a na poniższym przykładzie pokazana została składnia ich zapisu:

<tr ... runat="server">

Tabela B.23. Właściwości i zdarzenia elementów sterujących HtmlTableRow.

Właściwość	Opis
Cells	Zwraca obiekt klasy HtmlTableCellCollection reprezentujący wszystkie komórki tworzące dany wiersz tabeli.
InnerHtml	Kod HTML zapisany pomiędzy otwierającym i zamykającym znacznikiem elementu sterującego.
InnerText	Tekst zapisany pomiędzy otwierającym i zamykającym znacznikiem elementu sterującego.
VAlign	Określa pionowe wyrównanie komórek danego wiersza.

HtmlTextArea

Elementu sterujące HtmlTextArea reprezentują obszary tekstowe. Tabela B.24 przedstawia właściwości i zdarzenia tych elementów sterujący, a na poniższym przykładzie została pokazana składnia ich zapisu:

<textarea ... runat="server">

Tabela B.24. Właściwości i zdarzenia elementów sterujących HtmlTextArea.

Właściwość	Opis
Cols	Ilość kolumn danego elementu sterującego (wyrażona jako ilość znaków).
Name	Unikalna nazwa danego elementu sterującego.
Rows	Ilość wierszy które będą jednocześnie widoczne w danym elemencie sterującym.
Value	Zawartość elementu sterującego.
Zdarzenie	Opis
ServerChange	Zdarzenie zachodzi gdy zawartość tego elementu sterującego po przesłaniu na serwer będzie się różnić od jego poprzedniej zawartości.

Internetowe elementy sterujące

Internetowe elementy sterujące są obiektami przechowywanymi i wykonywanymi na serwerze, które generują kod HTML umożliwiający wyświetlenie danego elementu w przeglądarce WWW. W tej części rozdziału opisane zostały wszystkie dostępne internetowe elementy sterujące.

Wspólne właściwości wszystkich internetowych elementów sterujących

W tabeli B.25 zostały przedstawione właściwości i metody dostępne we wszystkich internetowych elementach sterujących ASP.NET, dziedziczone po klasie System.Web.UI.WebControls.WebControl.

Tabela C.25. Właściwości i metody dostępne we wszystkich internetowych elementach sterujących.

Właściwość	Opis
AccessKey	Określa znak, który stanowi skrót klawiaturowy ułatwiający przejście do danego elementu sterującego (po naciśnięciu odpowiedniego klawisza wraz z klawiszem Alt). Możliwość korzystania z tych skrótów jest dostępna wyłącznie w Internet Explorerze 4.0 i późniejszych następnych wersjach tej przeglądarki.
Attributes	Zwraca obiekt klasy AttributeCollection reprezentujący atrybutu każdego elementu sterującego (nie zawierają one atrybutów zdefiniowanych jako właściwości).
BackColor	Kolor tła elementu sterującego.
BorderColor	Kolor obramowania elementu sterującego.
BorderWidth	Szerokość obramowania wyświetlanego wokół elementu sterującego.
BorderStyle	Styl obramowania; właściwość ta może przybierać następujące wartości: Dashed, Dotted, Double, Inset, Groove, None, NotSet, Outset, Ridged oraz Solid.
ControlStyle	Styl elementu sterującego (używany w przypadku tworzenia własnych elementów sterujących).
ControlStyleCreated	Określa czy style skojarzony z danym elementem sterującym został utworzony.
CSSClass	Nazwa klasy kaskadowych arkuszy stylów, którą należy przypisać danemu elementowi sterującemu.
Enabled	Jeśli właściwość ta będzie miała wartość false, to element sterujący będzie działał w trybie tylko do odczytu.
Font	Atrybut stylu określający czcionkę jaką będzie wyświetlany dany element sterujący.
ForeColor	Kolor danego elementu sterującego (zazwyczaj jest to kolor tekstu wyświetlanego w danym elemencie).
Height	Wysokość elementu sterującego.
Style	Obiekt klasy CSSStyleCollection zawierający kolekcję tekstowych atrybutów które zostaną wykorzystane jako atrybuty stylu przy generacji zewnętrznego znacznika danego elementu sterującego.
TabIndex	Określa w jakiej kolejności będą uaktywniane poszczególne elementy sterujące wyświetlona na stronie WWW, przy naciskaniu klawisza Tab.
ToolTip	Tekst wyświetlany po umieszczeniu wskaźnika myszy w obszarze zajmowanym przez element sterujący.
Width	Szerokość elementu sterującego.
Metody	Opis
ApplyStyle	Wykorzystuje wszystkie niepuste ustawienia podanego obiektu klasy Style do określenia stylów danego elementu kontrolnego, modyfikując jego bieżące ustawienia.
CopyBaseAttributes	Kopiuje właściwości AccessKey, Enabled, ToolTip, TabIndex oraz Attributes ze wskazanego elementu sterującego i zapisuje je w danym elemencie.
MergeStyle	Wykorzystuje wszystkie niepuste ustawienia podanego obiektu klasy Style do określenia stylów danego elementu kontrolnego, bez modyfikacji jego bieżących ustawień.
RenderBeginTag	Generuje otwierający znacznik elementu HTML stanowiącego wizualny interfejs danego elementu sterującego i przesyła go do przeglądarki.
RenderEndTag	Generuje zamykający znacznik elementu HTML stanowiącego wizualny interfejs danego elementu sterującego i przesyła go do przeglądarki.

Tabela B.26 przedstawia właściwości i zdarzenia dostępne dla wszystkich internetowych elementów sterujących ASP.NET udostępniających możliwości funkcjonalne listy (są to elementy sterujące CheckBoxList, DropDownList, ListBox oraz RadioButtonList). Właściwości te i zdarzenia są dziedziczone po klasie System.Web.UI.WebControls.ListControl.

Tabela B.26. Właściwości i zdarzenia wszystkich internetowych elementów sterujących działających jako listy.

Właściwość	Opis
AutoPostBack	Określa czy formularz powinien zostać automatycznie przesłany bezpośrednio po wygenerowaniu zdarzenia dla danego elementu sterującego.
DataMember	Nazwa tabeli źródła danych z której będą pobierane informacje wykorzystywane przy generowaniu listy (właściwość ta jest stosowana gdy właściwości DataSource zostanie przypisany obiekt DataSet).
DataSource	Źródło danych, które zostanie wykorzystane przy generowaniu zawartości listy.
DataTextField	Pole źródła danych którego wartości zostaną użyte jako tekst poszczególnych opcji listy.
DataTextFormatString	Łańcuch znaków określający format w jakim będą wyświetlane wartości pola określonego we właściwości DataTextField.
DataValueField	Pole źródła danych, którego wartości staną się wartościami poszczególnych opcji listy.
Items	Obiekt klasy ListItemCollection zawierający wszystkie opcje dostępne na liście.
SelectedIndex	Indeks opcji aktualnie wybranej na liście.
SelectedItem	Obiekt klasy ListItem reprezentujący aktualnie wybraną opcję listy; jeśli w danej chwili na liście jest zaznaczonych więcej opcji, to ta właściwość zawiera obiekt reprezentujący tylko pierwszą z nich.
Zdarzenie	Opis
SelectedIndexChanged	Zdarzenie zachodzi gdy zmieniła się opcja zaznaczona na liście, a formularz został przesłany na serwer.

W tabeli B.27 zostały przedstawione właściwości, metody i zdarzenia dostępne we wszystkich internetowych elementach sterujących ASP.NET służących do generacji list danych (DataList oraz DataGrid). Te właściwości, metody i zdarzenia są dziedziczone po klasie System.Web.UI.WebControls.BaseDataList.

Tabela B.27. Właściwości, metody i zdarzenia wspólne dla wszystkich elementów sterujących generujących listy danych.

Właściwość	Opis
CellPadding	Wielkość obszaru pomiędzy zawartością komórki danych a jej krawędziami.
CellSpacing	Odległość pomiędzy poszczególnymi komórkami danych.
DataKeyField	Pole klucza głównego w źródle danych.
DataKeys	Obiekt klasy DataKeyCollection zawierający pola kluczy wykorzystywanego źródła danych.
DataMember	Nazwa tabeli źródła danych, z której będą pobierane informacje wyświetlane w danym elemencie sterującym (wykorzystywana gdy we właściwości DataSource zostanie zapisany obiekt DataSet).
DataSource	Źródło danych z którego będą pobierane informacje wyświetlane w tym elemencie sterującym.
GridLines	Określa styl linii wyświetlanych pomiędzy komórkami danych; właściwość ta może przyjmować wartości: Both, Horizontal, None bądź Vertical.
HorizontalAlign	Określa wyrównanie wierszy w stosunku do innych elementów strony.
Metody	Opis
DataBind	--> Wiąże dane ze źródła danych z elementem sterującym[Author:p8R] .
Zdarzenie	Opis
SelectedIndexChanged	Zachodzi gdy na liście została wybrana inna, a formularz został przesłany na serwer.

Internetowe elementy sterujące ASP.NET

W tej części rozdziału zostały opisane wszystkie internetowe elementy sterujące dostępne w ASP.NET. Składnia ich zapisu ma następującą postać:

<asp:nazwaElementuSterujacego właściwości runat="server" />

Na przykład, deklaracja elementu sterującego AdRotator opisanego poniżej, może mieć następującą postać:

<asp:AdRotator Target="blank" runat="server" />

AdRotator

Te elementy sterujące wyświetlają reklamę losowo wybraną z określonego zbioru reklam, zapisanego w formie pliku XML. Właściwości i zdarzenia tych elementów sterujących zostały przedstawione w tabeli B.28.

Tabela B.28. Właściwości i zdarzenia elementów sterujących AdRotator.

Właściwość	Opis
AdvertisementFile	Ścieżka dostępu do pliku XML zawierającego informacje o reklamach.
KeywordFilter	Filtr, który ogranicza jakie reklamy mogą być wyświetlane, na podstawie kategorii do jakiej należą i kategorii określonych w pliku XML zawierającym informacje o reklamach.
Target	Określa okno przeglądarki w jakim zostanie wyświetlona strona docelowa skojarzona z reklamą.
Zdarzenie	Opis
AdCreated	Zdarzenie zachodzi po utworzeniu elementu sterującego i przed wyświetleniem go na stronie. W procedurze obsługi tego zdarzenia wykorzystywany jest argument będący obiektem klasy AdCreateEventArgs. Obiekty tej klasy mają następujące właściwości: AdProperties — Właściwości aktualnie wybranej reklamy. AlternateText — Tekst alternatywny wyświetlany zamiast obrazka. ImageUrl — Adres URL obrazka jaki ma zostać wyświetlony na reklamie. NavigateUrl — Adres URL, pod który należy przekierować użytkownika.

BoundColumn

Elementy sterujące BoundColumn reprezentują kolumny elementów DataGrid i są kojarzone z polami źródła danych. Właściwości i metody elementów sterujących BoundColumn zostały przedstawione w tabeli B.29.

Tabela B.29. Właściwości i metody elementów sterujących BoundColumn.

Właściwość	Opis
DataField	Nazwa pola danych związanego z daną kolumną.
DataFormatString	Łańcuch znaków określający postać danych wyświetlanych w danej kolumnie.
ReadOnly	Określa czy dane wyświetlane w tej kolumnie są przeznaczone wyłącznie do odczytu (właściwość ta jest często stosowana wraz z elementami EditCommandColumns).
Metoda	Opis
Initialize	Inicjalizuje kolumnę.
InitializeCell	Inicjalizuje komórkę danej kolumny.

Button

Elementy sterujące Button powodują wyświetlenie przycisku HTML. Właściwości i zdarzenia tych elementów sterujących zostały przedstawione w tabeli B.30.

Tabela B.30. Właściwości i zdarzenia elementów sterujących Button.

Właściwość	Opis
CommandArgument	Wartość przekazywana wraz z wartością CommandName do zdarzenia Command.
CommandName	Polecenie skojarzone ze zdarzeniem Command.
Text	Zawartość elementu sterującego.
Zdarzenie	Opis
Click	Zachodzi w przypadku kliknięcia przycisku.
Command	To samo co zdarzenie Click.

ButtonColumn

Elementy sterujące ButtonColumn reprezentują kolumnę elementu DataGrid zawierającą grupę przycisków. Właściwości tych elementów sterujących zostały przedstawione w tabeli B.31.

Tabela B.31. Właściwości i zdarzenia elementów sterujących ButtonColumn.

Właściwość	Opis
ButtonType	Określa typ przycisku jaki należy wyświetlić; właściwość ta może przybierać wartości LinkButton lub PushButton.
CommandName	Łańcuch znaków reprezentujący polecenie jakie należy wykonać w przypadku kliknięcia przycisku.
DataTextField	Nazwa pola źródła danych, którego wartości są wyświetlane w tej kolumnie.
DataTextFormatString	Określa sposób w jaki należy wyświetlić zawartość pola wskazanego we właściwości DataTextField.
Text	Tytuł wyświetlany na przycisku.

Calendar

Elementy sterujące Calendar wyświetlają w przeglądarce interaktywny kalendarz dysponujący niezwykle bogatymi możliwościami określania sposobu prezentacji danych i działania. Właściwości tych elementów sterujących i generowane przez nie zdarzenia zostały przedstawione w tabeli B.32.

Tabela B.32. Właściwości i zdarzenia elementów sterujących Calendar.

Właściwość	Opis
CellPadding	Wielkość obszaru pomiędzy zawartością komórki prezentującej numer dnia, a jej krawędziami.
CellSpacing	Wielkość wzajemnej odległości pomiędzy poszczególnymi komórkami prezentującymi numery dni.
DayHeaderStyle	Styl jakim mają być wyświetlane nazwy dni tygodnia.
DayNameFormat	Format w jakim będą wyświetlane nazwy dni tygodnia; właściwość ta może przybierać wartości: FirstLetter, FirstTwoLetters, Full oraz Short.
DayStyle	Styl wyświetlania numerów dni.
FirstDayOfWeek	Określa dzień, który w kalendarzu będzie wyświetlany jako pierwszy dzień tygodnia; właściwość ta może przybierać wartość: Default (wartość domyślna określona przez serwer) oraz dowolną nazwę dnia (od Sunday do Saturday).
NextMonthText	Tekst wyświetlany na pasku nawigacyjnym kalendarza, umożliwiający przejście do następnego miesiąca (na przykład "Następny" lub ">").
NextPrevFormat	Format w jakim będą wyświetlane połączenia do następnego i poprzedniego miesiąca; może przybierać wartości: CustomText (jest to wartość domyślna, należy ją stosować w przypadkach gdy są także używane właściwości NextMonthText oraz PrevMonthText), FullMonth lub ShortMonth.
NextPrevStyle	Styl w jakim będą wyświetlane połączenia do poprzedniego i następnego miesiąca.
OtherMonthDayStyle	Styl w jakim będą wyświetlane dni które nie należą do bieżącego miesiąca wyświetlanego w kalendarzu.
PrevMonthText	Tekst wyświetlany na pasku nawigacyjnym kalendarza, umożliwiający przejście do poprzedniego miesiąca (na przykład "Poprzedni" lub "<").
SelectedDate	Data wybrana w kalendarzu.
SelectedDates	Kolekcja obiektów DateTime reprezentujących daty wybrane w kalendarzu.
SelectedDayStyle	Styl w jakim będą wyświetlane wybrane dni.
SelectionMode	Określa w jaki sposób użytkownik będzie mógł zaznaczać dni w kalendarzu (na przykład, pojedynczy dzień, całe tygodnie, itd.); może przyjmować wartości Day, DayWeek, DayWeekMonth lub None.
SelectMonthText	Tekst wyświetlany jako połączenie służące do wyboru miesięcy.
SelectorStyle	Styl określający postać połączeń umożliwiających wybór tygodni i miesięcy.
SelectWeekText	Tekst wyświetlany na połączeniu służącym do wyboru tygodni.
ShowDayHeader	Określa czy w kalendarzu powinne być wyświetlane nagłówki dni tygodnia.
ShowGridLines	Określa czy należy wyświetlać linie oddzielające numery poszczególnych dni wyświetlanych w kalendarzu.
ShowNextPrevMonth	Określa czy należy wyświetlać połączenia do poprzedniego i następnego miesiąca.
ShowTitle	Określa czy należy wyświetlać tytuł kalendarza.
TitleFormat	Określa format w jakim będzie wyświetlany tytuł kalendarza; dostępne wartości to Month lub MonthYear.
TitleStyle	Styl w jakim będzie wyświetlony tytuł kalendarza.
TodayDayStyle	Styl w jaki zostanie wyświetlona bieżąca data.
TodaysDate	Określa dzisiejszą datę.
VisibleDate	Data określająca miesiąc jaki będzie wyświetlony w kalendarzu (warto zwrócić uwagę, iż wybrana data oraz data określająca wyświetlony miesiąc nie muszą być identyczne).
WeekendDayStyle	Styl w jakim będą wyświetlane dni wolne.
Zdarzenie	Opis
DayRender	Zachodzi podczas tworzenia każdej komórki wyświetlającej numer dnia. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DayRenderEventArgs. Obiekty tej klasy zawierają dwie właściwości: Cell — Obiekt klasy TableCell reprezentujący komórkę wyświetlaną w kalendarzu. Day — Obiekt klasy CalendarDay reprezentujący dzień wyświetlany w kalendarzu.
SelectionChanged	Zachodzi gdy użytkownik wybierze w kalendarzu dzień, tydzień lub miesiąc.
VisibleMonthChanged	Zachodzi gdy użytkownik wyświetli w kalendarzu inny miesiąc. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy MonthChangedEventArgs. Klasa ta definiuje następujące właściwości: NewDate — Data określająca jaki miesiąc aktualnie będzie widoczny w kalendarzu. PreviousDate — Data określająca jaki miesiąc był poprzednio wyświetlany w kalendarzu.

CheckBox

Elementy sterujące CheckBox reprezentują pola wyboru HTML. Właściwości tych elementów kontrolnych oraz generowane przez nie zdarzenia zostały przedstawione w tabeli B.33.

Tabela B.33. Właściwości i zdarzenia elementów sterujących CheckBox.

Właściwość	Opis
AutoPostBack	Określa czy formularz powinien być przesłany niezwłocznie po zajściu zdarzenia CheckedChanged.
Checked	Określa czy dany element sterujący jest zaznaczony.
Text	Tekst wyświetlany obok pola wyboru.
TextAlign	Wyrównanie tekstu wyświetlanego wraz z polem wyboru.
Zdarzenie	Opis
CheckedChanged	Zachodzi gdy zmieni się wartość właściwości Checked.

CheckBoxList

Elementy sterujące CheckBoxList wyświetlają w przeglądarce listę związanych ze sobą tematycznie pól wyboru. Właściwości tych elementów kontrolnych zostały przedstawione w tabeli B.34.

Tabela B.34. Właściwości i zdarzenia elementów sterujących CheckBoxList.

Właściwość	Opis
CellPadding	Wielkość obszaru pomiędzy zawartością i krawędziami komórki zawierające elementy sterujące CheckBox.
CellSpacing	Odległość pomiędzy poszczególnymi komórkami zawierającymi elementy sterujące CheckBox.
RepeatColumns	Ilość kolumn w jakim mający być wyświetlane elementy sterujące.
RepeatDirection	Określa czy elementy sterujące CheckBox mają być wyświetlane w poziomie (Horizontal) czy też w pionie (Vertical).
RepeatLayout	Określa układ listy; właściwość może przyjmować wartość Table (aby lista elementów sterujących CheckBox była wyświetlana przy wykorzystaniu tabeli) bądź Flow (aby była wyświetlana baz użycia tabeli).
TextAlign	Określa wyrównanie tekstu skojarzonego z każdym z elementów sterujących CheckBox.

DataGrid

Elementy sterujące DataGrid wyświetlają złożoną tabelę zawierającą dane pobierane z podanego źródła. Właściwości tych elementów kontrolnych oraz generowane przez nie zdarzenia zostały przedstawione w tabeli B.35.

Tabela B.35. Właściwości i zdarzenia elementów sterujących DataGrid.

Właściwość	Opis
AllowCustomPaging	Określa czy programista może określać sposób podziału na strony danych wyświetlanych w elemencie sterującym.
AllowPaging	Określa czy element sterujący ma wyświetlać dane dzieląc je na strony.
AllowSorting	Określa czy ma być wykorzystywane sortowanie danych.
AlternatingItemStyle	Właściwości stylów które będą modyfikować sposób prezentacji poszczególny elementów wyświetlanych w elemencie sterującym DataGrid.
AutoGenerateColumns	Określa czy element sterujący DataGrid powinien automatycznie wygenerować kolumny związane (BoundColumn) na podstawie informacji zwróconych ze źródła danych (w takim przypadku element DataGrid wykorzysta wszystkie kolumny zwrócone ze źródła danych).
BackImageUrl	URL obrazka jaki ma być wyświetlony w tle elementu sterującego.
Columns	Kolekcja obiektów reprezentujących kolumny elementu sterującego DataGrid.
CurrentPageIndex	Indeks aktualnie wyświetlonej strony.
EditItemIndex	Indeks elementu który ma być edytowany (w tym przypadku kolumna BoundColumn będzie umożliwiała edycję danych, chyba że jawnie określono, że ma być przeznaczona wyłącznie do odczytu).
EditItemStyle	Styl służący do wyświetlania elementów w trybie edycji.
FooterStyle	Styl stopki elementu sterującego DataGrid.
HeaderStyle	Styl nagłówka elementu sterującego DataGrid.
Items	Kolekcja obiektów DataGridItem reprezentujących poszczególne elementy wyświetlone w elemencie sterującym DataGrid.
ItemStyle	Styl poszczególnych elementów wyświetlanych w elemencie sterującym DataGrid.
PageCount	Ilość stron koniecznych do wyświetlenia wszystkich informacji przechowywanych w elemencie sterującym DataGrid.
PagerStyle	Styl połączeń umożliwiających poruszanie się pomiędzy poszczególnymi stronami danych.
PageSize	Określa ilość elementów jakie mają być wyświetlane na jednej stronie.
SelectedIndex	Indeks aktualnie wybranego elementu.
SelectedItem	Wybrany element.
SelectedItemStyle	Styl aktualnie wybranego elementu.
ShowFooter	Określa czy należy wyświetlać stopkę elementu sterującego.
ShowHeader	Określa czy należy wyświetlać nagłówek elementu sterującego.
VirtualItemCount	Określa całkowitą ilość elementów jakie mają być wyświetlane w elemencie sterującym DataGrid. Właściwość ta jest stosowana wyłącznie w sytuacjach, gdy właściwości AllowCustomPaging została przypisana wartość true.
Zdarzenie	Opis
CancelCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Cancel". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridCommandEventArgs. Klasa ta definiuje następujące właściwości: CommandArgument — Argument danego polecenia. CommandName — Nazwa danego polecenia. CommandSource — Obiekt, który spowodował wygenerowanie zdarzenia.
DeleteCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Delete". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridCommandEventArgs.
EditCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Edit". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridCommandEventArgs.
ItemCommand	Zachodzi gdy zostanie kliknięty przycisk; argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridCommandEventArgs.
ItemCreated	Zachodzi bezpośrednio przed utworzeniem elementu w elemencie sterującym DataGrid. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridItemEventArgs. Klasa ta definiujące następującą właściwość: Item — Aktualnie wybrany element.
ItemDataBound	Zachodzi gdy z elementem należącym do elementu sterującego DataGrid są wiązane dane. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridItemEventArgs.
PageIndexChanged	Zachodzi w przypadku kliknięcia jednego z połączeń umożliwiających poruszanie się pomiędzy poszczególnymi stronami danych. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridPageChangedEventArgs. Klasa ta definiuje następując właściwości: CommandSource — Zawiera obiekt który spowodował wygenerowanie zdarzenia. NewPageIndex — Określa indeks wybranej, nowej strony.
SortCommand	Zachodzi gdy jest sortowana kolumna. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridSortCommandEventArgs. Klasa ta definiuje następujące właściwości: CommandSource — Zawiera obiekt, który spowodował wygenerowanie zdarzenia. SortExpression — Wyrażenie służące do sortowania danych prezentowanych w elemencie sterującym DataGrid.
UpdateCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Update". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataGridCommandEventArgs.

DataList

Elementy sterujące DataList umożliwiają wyświetlanie zawartości źródła danych przy wykorzystaniu szablonów. W tabeli B.36 zostały przedstawione pola i właściwości tych elementów sterujących oraz generowane przez nie zdarzenia.

Tabela B.36. Pola, właściwości oraz zdarzenia elementów sterujących DataList.

Pole	Opis
CancelCommandName	Nazwa polecenia Cancel.
DeleteCommandName	Nazwa polecenia Delete.
EditCommandName	Nazwa polecenia Edit.
SelectCommandName	Nazwa polecenia Select.
UpdateCommandName	Nazwa polecenia Update.
Właściwość	Opis
AlternatingItemStyle	Właściwości stylów służące do modyfikowania sposobu prezentacji poszczególnych elementów wyświetlanych na liście.
AlternatingItemTemplate	Szablon służący do wyświetlania elementów listy, których wygląd będzie się zmieniał.
EditItemIndex	Indeks elementu listy który ma być edytowany.
EditItemStyle	Styl elementów będących w trybie edycji.
EditItemTemplate	Szablon służący do wyświetlania elementów będących w trybie edycji.
ExtractTemplateRows	Określa czy wiersze szablonu powinne być pobierane.
FooterStyle	Styl stopki elementu sterującego DataList.
FooterTemplate	Szablon stopki elementu sterującego DataList.
GridLines	Określa typ wyświetlanych pomiędzy poszczególnymi elementami listy; właściwość ta może przyjmować wartości Both, Horizontal, None bądź Vertical.
HeaderStyle	Styl nagłówka elementu sterującego DataList.
HeaderTemplate	Szablon nagłówka elementu sterującego DataList.
Items	Kolekcja obiektów klasy DataListItem reprezentujących poszczególne elementy wyświetlane na liście.
ItemStyle	Styl elementów wyświetlanych na liście.
ItemTemplate	Szablon elementów wyświetlanych na liście.
RepeatColumns	Ilość kolumn w jakich będą wyświetlane informacje.
RepeatDirection	Kierunek w jakim będą wyświetlane poszczególne elementy listy; właściwość ta może przyjmować wartości Horizontal lub Vertical.
RepeatLayout	Układ w jakim mają być wyświetlane poszczególne elementy listy; właściwość ta może przyjmować wartości Table lub Flow.
SelectedIndex	Indeks aktualnie wybranego elementu listy.
SelectedItem	Wybrany element listy.
SelectedItemStyle	Styl wybranego elementu listy.
SelectedItemTemplate	Szablon służący do wyświetlania aktualnie wybranego elementu listy.
SeparatorStyle	Styl separatora oddzielającego poszczególne elementy listy.
SeparatorTemplate	Szablon służący do wyświetlania separatora pomiędzy poszczególnymi elementami listy.
ShowFooter	Określa czy należy wyświetlać stopkę.
ShowHeader	Określa czy należy wyświetlać nagłówek.
Zdarzenie	Opis
CancelCommand	--> Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Cancel". [Author:p8R] Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListCommandEventArgs. Klasa ta definiuje następujące właściwości: CommandArgument — Argument danego polecenia. CommandName — Nazwa danego polecenia. CommandSource — Obiekt, który spowodował wygenerowanie zdarzenia. Item — Wybrany element listy.
DeleteCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Delete". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListCommandEventArgs.
EditCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Edit". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListCommandEventArgs.
ItemCommand	Zachodzi gdy zostanie kliknięty przycisk --> jakikolwiek przycisk wyświetlony w elemencie sterującym DataList[Author:p8R] ; argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListCommandEventArgs.
ItemCreated	Zachodzi bezpośrednio przed utworzeniem elementu w elemencie sterującym DataList. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListItemEventArgs. Klasa ta definiujące następującą właściwość: Item — Aktualnie wybrany element.
ItemDataBound	Zachodzi gdy z elementem należącym do elementu sterującego DataList są wiązane dane. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListItemEventArgs.
UpdateCommand	Zachodzi gdy zostanie kliknięty przycisk, którego właściwości CommandName jest przypisana wartość "Update". Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy DataListCommandEventArgs.

DropDownList

Elementy sterujące DropDownList reprezentują listę rozwijaną. Ich właściwości zostały przedstawione w tabeli B.37.

Tabela B.37. Właściwości elementów sterujących DropDownList.

Właściwość	Opis
BorderColor	Kolor obramowania otaczającego listę.
BorderStyle	Styl obramowania otaczającego listę.
BorderWidth	Szerokość obramowania otaczającego listę.
SelectedIndex	Indeks aktualnie wybranego elementu listy.

EditCommandColumn

Elementy sterujące EditCommandColumn reprezentują kolumnę wyświetlaną w elementach sterujących DataGrid, zawierającą połączenie umożliwiające edycję danych. Właściwości tych elementów sterujących zostały przedstawione w tabeli B.38.

Tabela B.38. Właściwości elementów sterujących EditCommandColumn.

Właściwość	Opis
ButtonType	Typ przycisku jaki ma zostać wyświetlony; dostępne wartości tej właściwości to LinkButton oraz PushButton.
CancelText	Tekst jaki ma zostać wyświetlony na przycisku przerywającym operację.
EditText	Tekst jaki ma zostać wyświetlony na przycisku umożliwiającym edycję danych.
UpdateText	Tekst jaki ma zostać wyświetlony na przycisku umożliwiającym aktualizację danych.

HyperLink

Te elementy sterujące reprezentują połączenia HTML. Należy zwrócić uwagę, że elementy te nie generują żadnych zdarzeń — powodują jedynie przekierowanie. Jeśli chcemy aby były generowane zdarzenia związane z wykonaniem operacji na danym elemencie sterującym, to będziemy musieli posłużyć się internetowym elementem sterującym LinkButton. Właściwości elementów sterujących HyperLink zostały przedstawione w tabeli B.39.

Tabela B.39. Właściwości elementów sterujących HyperLink.

Właściwość	Opis
ImageUrl	Adres URL obrazu jaki ma reprezentować połączenie.
NavigateUrl	Docelowy adres URL danego połączenia.
Target	Okno przeglądarki w którym ma być wyświetlona strona docelowa połączenia.
Text	Tekst który zostanie wyświetlony jako połączenie.

HyperLinkColumn

Elementy sterujące HyperLinkColumn reprezentują kolumny wyświetlane w elementach sterujących DataGrid i skojarzone ze wskazanym polem źródła danych. Wartości tych pól zostaną wyświetlone jako połączenia. Właściwości i metody elementów sterujących HyperLinkColumn zostały przedstawione w tabeli B.40.

Tabela B.40. Właściwości i metody elementów sterujących HyperLinkColumn.

Właściwość	Opis
DataNavigateUrlField	Nazwa pola źródła danych, którego wartości będą określać docelowy adres URL dla pól danej kolumny.
DataNavigateUrlFormatString	Format w jakim będą wyświetlane wartości pola źródła danych zawierającego adres docelowy pól danej kolumny.
DataTextField	Nazwa pola źródła danych, którego wartości będą wyświetlane w danej kolumnie jako tekst połączenia.
DataTextFormatString	Format w jakim będą wyświetlane wartości pola zawierającego tekst połączenia.
--> NavigateUrl[Author:p8R]	Adres URL pod który należy skierować przeglądarkę w momencie kliknięcia połączenia.
Target	Okno przeglądarki w którym należy wyświetlić docelową stronę połączenia.
Text	Tekst połączenia wyświetlany na stronie.
Metoda	Opis
Initialize	Inicjalizuje daną kolumnę.
InitializeCell	Inicjalizuje komórkę danej kolumny.

Image

Elementy sterujące Image reprezentują obrazy wyświetlane w przeglądarce. Właściwości tych elementów sterujących zostały przedstawione w tabeli B.41.

Tabela B.41. Właściwości elementów sterujących Image.

Właściwość	Opis
AlternateText	Tekst alternatywny, wyświetlany zamiast obrazu.
Enabled	Określa czy dany element sterujący jest włączony.
Font	Właściwości czcionki jaką będzie wyświetlany tekst alternatywny.
ImageAlign	Wyrównanie danego obrazu na stronie, w stosunku do pozostałych elementów interfejsu użytkownika.
ImageUrl	Adres URL obrazka który należy wyświetlić.

ImageButton

Elementy sterujące ImageButton reprezentują graficzne przyciski formularzy HTML (czyli przyciski na których jest wyświetlany obraz). Właściwości tych elementów sterujących oraz generowane przez nie zdarzenia zostały przedstawione w tabeli B.42.

Tabela B.42. Właściwości i zdarzenia elementów sterujących ImageButton.

Właściwość	Opis
CommandArgument	Argument dostarczający dodatkowych informacji na temat właściwości CommandName.
CommandName	Nazwa polecenia jakie należy wykonać w przypadku kliknięcia elementu sterującego.
Zdarzenie	Opis
Click	Zachodzi gdy element sterujący zostanie kliknięty.
Command	Zachodzi gdy element sterujący zostanie kliknięty.

Label

Te elementy sterujące wyświetlają zwyczajny tekst w przeglądarce. Elementy te posiadają jedną jedyną właściwość, która została przedstawiona w tabeli B.43.

Tabela B.43. Właściwość elementów sterujących Label.

Właściwość	Opis
Text	Tekst wyświetlany w przeglądarce.

LinkButton

Elementy sterujące LinkButton reprezentują przycisk formularzy HTML prezentowany w formie połączenia a nie klasycznego przycisku. Właściwości elementów sterujących LinkButton oraz generowane przez nie zdarzenie zostały opisane w tabeli B.44.

Tabela B.44. Właściwości i zdarzenia elementów sterujących LinkButton.

Właściwość	Opis
CommandArgument	Argument dostarczający dodatkowych informacji na temat właściwości CommandName.
CommandName	Nazwa polecenia jakie należy wykonać w przypadku kliknięcia przycisku.
Text	Tekst połączenia wyświetlany na stronie.
Zdarzenie	Opis
Click	Zachodzi gdy przycisk zostanie kliknięty.
Command	Zachodzi gdy przycisk zostanie kliknięty.

ListBox

Elementy sterujące ListBox reprezentują rozwijane listy. Ich właściwości zostały przedstawione w tabeli B.45.

Tabela B.45. Właściwości elementów sterujących ListBox.

Właściwość	Opis
BorderColor	Kolor obramowania otaczającego listę.
BorderStyle	Styl obramowania otaczającego listę.
BorderWidth	Szerokość obramowania otaczającego listę.
Rows	Ilość wierszy, które będą widoczne na liście.
SelectionMode	Określa czy na liście będzie można zaznaczyć tylko jedną opcje (Single) czy też dowolną ich ilość (Multiple).

Panel

Te elementy sterujące reprezentują element „kontenerowy” — służący do umieszczania innych elementów sterujących. Właściwości elementów sterujących Panel zostały przedstawione w tabeli B.46.

Tabela B.46. Właściwości elementów sterujących Panel.

Właściwość	Opis
BackImageUrl	Określa adres URL obrazu który ma być wyświetlony w tle elementu sterującego.
HorizontalAlign	Określa wyrównanie zawartości danego elementu sterującego w poziomie.
Wrap	Określa czy zawartość elementu sterującego może być zawijana.

RadioButton

Elementy sterujące RadioButton reprezentują przyciski opcji HTML. RadioButton jest klasą potomną klasy CheckBox, a zatem dysponuje wszystkim jej właściwościami i zdarzeniami. Nowa właściwość, dostępna wyłącznie w elementach sterujących RadioButton została przedstawiona w tabeli B.47.

Tabela B.47. Właściwości elementów sterujących RadioButton.

Właściwość	Opis
GroupName	Nazwa grupy do jakiej należy dany przycisk opcji.

RadioButtonList

Elementy sterujące RadioButtonList wyświetlają w przeglądarce listę powiązanych ze sobą tematycznie przycisków opcji. Właściwości tego elementu sterującego zostały przedstawione w tabeli B.48.

Tabela B.48. Właściwości elementów sterujących RadioButtonList.

Właściwość	Opis
CellPadding	Wielkość obszaru pomiędzy elementem sterującym RadioButton wyświetlonym w komórce a jej krawędziami.
CellSpacing	Wzajemna odległość pomiędzy poszczególnymi komórkami zawierającymi elementy sterujące RadioButton.
RepeatColumns	Liczba kolumn w jakich ma być wyświetlana zawartość listy.
RepeatDirection	Określa czy elementy sterujące RadioButton mają być wyświetlane w poziomie (Horizontal) czy też w pionie (Vertical).
RepeatLayout	Określa układ listy; właściwość może przyjmować wartość Table (aby lista elementów sterujących RadioButton była wyświetlana przy wykorzystaniu tabeli) bądź Flow (aby była wyświetlana baz użycia tabeli).
TextAlign	Określa wyrównanie tekstu skojarzonego z każdym z elementów sterujących RadioButton.

Repeater

Elementy sterujące Repeater wyświetlają informacje z podanego źródła danych przy wykorzystaniu podanego szablonu. Właściwości tych elementów sterujących oraz generowane przez nie zdarzenia zostały przedstawione w tabeli C.49.

Tabela C.49. Właściwości i zdarzenia elementów sterujących Repeater.

Właściwość	Opis
AlternatingItemTemplate	Szablon jaki zostanie wykorzystany do modyfikowania wyglądu zawartości danego elementu sterującego.
DataMember	Tabela która ma zostać użyta przy wiązaniu danych (właściwość ta jest wykorzystywana wyłącznie jeśli właściwości DataSource zostanie przypisany obiekt DataSet).
DataSource	Źródło danych którego należy użyć przy wiązaniu danych z tym elementem sterującym.
FooterTemplate	Szablon służący do określania postaci stopki.
HeaderTemplate	Szablon służący do określania postaci nagłówka.
Items	Kolekcja obiektów klasy RepeaterItem reprezentujących poszczególne elementy wyświetlone w danym elemencie sterującym Repeater.
ItemTemplate	Szablon służący do określania postaci poszczególnych elementów wyświetlanych w elemencie sterującym Repeater.
SeparatorTemplate	Szablon określający postać separatora wyświetlanego pomiędzy poszczególnymi elementami prezentowanymi w danym elemencie sterującym Repeater.
Zdarzenie	Opis
ItemCommand	Zachodzi gdy --> zostanie kliknięty jakikolwiek przycisk wyświetlony w elemencie sterującym Repeater[Author:p8R] . Argumentem wywołania procedury tego zdarzenia jest obiekt klasy RepeaterCommandEventArgs. Klasa ta definiuje następujące właściwości: CommandArgument — Argument polecenia. CommandName — Nazwa polecenia. CommandSource — Obiekt, który wygenerował zdarzenie. Item — Obiekt RepeaterItem skojarzony z danym zdarzeniem.
ItemCreated	Zachodzi bezpośrednio przed utworzeniem każdego z elementów wyświetlanych w elemencie sterującym Repeater. Argumentem wywołania procedury obsługi tej metody jest obiekt klasy RepeaterItemEventArgs. Klasa ta definiuje jedną właściwość: Item — Określa aktualnie wybrany element.
ItemDataBound	Zachodzi gdy z elementem wyświetlanym w elemencie sterującym Repeater są wiązane dane. Argumentem wywołania procedury obsługi tego zdarzenia jest obiekt klasy RepeaterItemEventArgs.

Table, TableCell oraz TableRow

Elementy sterujące Table, TableCell oraz TableRow reprezentują tabele HTML, ich komórki oraz wiersze. Właściwości elementów sterujących Table zostały przedstawione w tabeli B.50.

Tabela B.50. Właściwości elementów sterujących Table.

Właściwość	Opis
BackImageUrl	Adres URL obrazu który ma zostać wyświetlony w tle tabeli.
CellPadding	Wielkość obszaru pomiędzy zawartością komórek tabeli a ich krawędziami.
CellSpacing	Wielkość wzajemnych odległości pomiędzy poszczególnymi komórkami tabeli.
GridLines	Styl linii wyświetlanych pomiędzy poszczególnymi komórkami tabeli; właściwość ta może przyjmować wartości: Both, Horizontal, None bądź Vertical.
HorizontalAlign	Wyrównanie tabeli w poziomie.
Rows	Zwraca obiekt klasy TableRowCollection reprezentujący wszystkie wiersze tabeli.

W tabeli B.51 zostały przedstawione właściwości elementów sterujących TableCell. Należy zauważyć, iż dostępne są także elementy sterujące TableHeaderCell. Klasa TableHeaderCell dziedziczy po klasie TableCell i udostępnia te same właściwości.

Tabela B.51. Właściwości elementów sterujących TableCell.

Właściwość	Opis
ColumnSpan	Ilość kolumn które obejmuj dana komórka tabeli.
HorizontalAlign	Wyrównanie zawartości komórki w poziomie.
RowSpan	Ilość wierszy które obejmuje dana komórka tabeli.
Text	Tekst wyświetlany w danej komórce tabeli.
VerticalAlign	Wyrównanie zawartości komórki w pionie.
Wrap	Określa czy tekst wyświetlany w komórce może być zawijany.

Tabela B.52 przedstawia właściwości elementów sterujących TableRow.

Właściwość	Opis
Cells	Zwraca obiekt klasy TableCellCollection reprezentujący wszystkie komórki tabeli zapisane w danym jej wierszu.
HorizontalAlign	Wyrównanie zawartości komórek w poziomie.
VerticalAlign	Wyrównanie zawartości komórek w pionie.

TemplateColumn

Elementy sterujące TemplateColumn reprezentują kolumny wyświetlane w elementach sterujących DataGrid. Właściwości tych elementów sterujących zostały przedstawione w tabeli B.53.

Tabela B.53. Właściwości elementów sterujących TemplateColumn.

Właściwość	Opis
EditItemTemplate	Szablon określający sposób wyświetlania elementu znajdującego się w trybie edycji.
FooterTemplate	Szablon określający wygląd stopki danej kolumny.
HeaderTemplate	Szablon określający wygląd nagłówka danej kolumny.
ItemTemplate	Szablon określający wygląda zwyczajnych elementów danej kolumny.

TextBox

Elementy sterujące TextBox reprezentują pola tekstowe HTML. Właściwości tych elementów sterujących oraz generowane przez nie zdarzenia zostały przedstawione w tabeli B.54.

Tabela B.54. Właściwości i zdarzenia elementów sterujących TextBox.

Właściwość	Opis
AutoPostBack	Określa czy formularz powinien zostać przesłany bezpośrednio po zgłoszeniu zdarzenia TextChanged.
Columns	Określa szerokość pola wyrażoną jako ilość znaków jakie będą w nim widoczne.
MaxLength	Określa maksymalną ilość znaków które będzie można wpisać w danym polu.
ReadOnly	Określa czy zawartość pola będzie przeznaczona tylko do odczytu.
Rows	Ilość wierszy jakie należy wyświetlać w przypadku gdy dany element sterujący jest prezentowany w formie wielowierszowego pola tekstowego.
Text	Tekst wyświetlany w polu.
TextMode	Określa sposób działania elementu sterującego; właściwość ta może przyjmować następujące wartości: MultiLine, Password oraz SingleLine (wartość domyślna).
Wrap	Określa czy w przypadku wielowierszowego pola tekstowego, tekst powinien być zawijany.
Zdarzenie	Opis
TextChanged	Zgłaszane po przesłaniu formularza, gdy okaże się że wartość właściwości Text uległa zmianie.

Elementy sterujące służące do kontroli poprawności danych

W tej części rozdziału zostały przedstawione szczegółowe informacje o właściwościach wszystkich elementów sterujących ASP.NET służących do kontroli poprawności danych. Elementy te służą do kontroli poprawności informacji podawanych w innych elementach sterujących.

Wspólne właściwości wszystkich elementów sterujących służących do kontroli poprawności danych

W tabeli B.55 zostały przedstawione właściwości i metody dostępne we wszystkich elementach sterujących służących do kontroli poprawności za wyjątkiem elementu sterującego ValidationSummary. Właściwości te i metody dziedziczone są po klasie System.Web.UI.WebControls.BaseValidator.

Tabela B.55. Właściwości i metody klasy BaseValidator.

Właściwość	Opis
ControlToValidate	Określa element sterujący zawierający informacje których poprawność należy sprawdzić.
Display	Sposób prezentacji danego elementu sterującego; właściwość ta może przyjmować następujące wartości: None — Komunikat o błędzie nie będzie wyświetlany. Static — Jeśli podczas sprawdzenia poprawności danych pojawią się błędy, to komunikat o nich zostanie wyświetlony na miejscu elementu sterującego, którego zawartość była sprawdzana. W takim przypadku element sterujący jest uwzględniany (zabiera miejsce) w ogólnym układzie strony, nawet jeśli aktualnie nie jest wyświetlany żaden komunikat o błędzie. Dynamic — Komunikaty są wyświetlane jeśli podczas sprawdzania poprawności danych pojawią się jakieś błędy, a jeśli żaden komunikat nie jest wyświetlany, to element sterujący nie jest uwzględniany w układzie strony.
EnableClientScript	Określa czy należy wygenerować skrypt, który będzie sprawdzać poprawność danych po stronie klienta.
ErrorMessage	Komunikat jaki należy wyświetlić w przypadku podania niepoprawnych informacji.
ForeColor	Kolor jakim należy wyświetlić komunikat.
IsValid	Określa czy informacje wprowadzone w elemencie sterującym określonym we właściwości ControlToValidate są poprawne.
Metoda	Opis
Validate	Określa czy sprawdzana zawartość wskazanego elementu sterującego jest poprawna czy nie i odpowiednio określa wartość właściwości IsValid.

Elementy sterujące służące do kontroli poprawności danych

W tej części rozdziału zostały podane szczegółowe informacje na temat wszystkich elementów sterujących służących do kontroli poprawności danych. Aby elementy te działały poprawnie, w ich właściwości ControlToValidate należy określić element sterujący, którego zawartość ma być sprawdzana.

CompareValidator

Ten elementy sterująca porównują wartości podane w sprawdzanym elemencie sterującym z inną wartością bądź z wartością podaną w innym elemencie sterującym. Właściwości elementów sterujących CompareValidator zostały przedstawione w tabeli B.56.

Tabela B.56. Właściwości elementów sterujących CompareValidator.

Właściwość	Opis
ControlToCompare	Identyfikator elementu sterującego z którym mają być porównywane wartości sprawdzanego elementu sterującego.
Operator	Określa operację jaką należy wykonać; właściwość ta może przyjmować następujące wartości: DataTypeCheck, Equal, GreaterThan, GreaterThanEqual, LessThan, LessThanEqual bądź NotEqual.
ValueToCompare	Wartość stała z jaką mają być porównywane wartości sprawdzanego elementu sterującego.

CustomValidator

Elementy sterujące CustomValidator umożliwiają realizację kontroli poprawności danych przy wykorzystaniu procedury wykonywanej po stronie klienta lub na serwerze i napisanej przez twórcę strony ASP.NET. Właściwości tych elementów sterujących oraz generowane przez nie zdarzenia zostały przedstawione w tabeli B.57.

Tabela B.57. Właściwości i zdarzenia elementów sterujących CustomValidator.

Właściwość	Opis
ClientValidationFunction	Funkcja, która powinna zostać wykonana po stronie klienta w celu określenia czy informacje podane we wskazanym elemencie sterującym są poprawne.
Zdarzenie	Opis
ServerValidate	Zachodzi po przesłaniu formularza na serwer i określa jaka metoda powinna zostać wykonana w celu określenia czy informacje podane we wskazanym elemencie sterującym są poprawne.

RangeValidator

Elementy sterujące RangeValidator porównują wartość zapisaną w sprawdzanym elemencie sterującym z określonym zakresem wartości dopuszczalnych. Właściwości tych elementów sterujących zostały przedstawione w tabeli B.58.

Tabela B.58. Właściwości elementów sterujących RangeValidator.

Właściwość	Opis
MaximumValue	Wartość maksymalna jaką może przyjąć sprawdzany element sterujący; może to być liczba lub łańcuch znaków.
MinimumValue	Wartość minimalna jaką może przyjąć sprawdzany element sterujący; może to być liczba lub łańcuch znaków.

RegularExpressionValidator

Elementy sterujące RegularExpressionValidator porównują zawartość wskazanego elementu sterującego z podanym wyrażeniem regularnym. Jedyna właściwość tych elementów sterujących została przedstawiona w tabeli B.59.

Tabela B.59. Właściwość elementów sterujących RegularExpressionValidator.

Właściwość	Opis
ValidationExpression	Wyrażenie regularne które zostanie użyte do sprawdzenia poprawności wskazanego elementu sterującego.

RequiredFieldValidator

Elementy sterujące RequiredFieldValidator zapewniają, że w sprawdzanym elemencie sterującym zostaną wpisane jakieś informacje (innymi słowy, że element ten nie będzie pusty). Jedyna właściwość tych elementów sterujących została przedstawiona w tabeli B.60.

Tabela B.60. Właściwość elementów sterujących RequiredFieldValidator.

Właściwość	Opis
InitialValue	Wartość początkowa sprawdzanego elementu sterującego.

ValidationSummary

Elementy sterujące ValidationSummary stanowią punkt centralny dla wszystkich innych elementów służących do kontroli poprawności podawanych informacji i umożliwiają wyświetlanie wszystkich komunikatów o błędach. Elementów tych można używać w połączeniu z komunikatami o błędach generowanymi przez inne elementy sterujące służące do kontroli poprawności danych. Ich właściwości zostały przedstawione w tabeli B.61.

Tabela B.61. Właściwości elementów sterujących ValidationSummary.

Właściwość	Opis
DisplayMode	Określa zachowanie danego elementu sterującego; właściwość ta może przyjmować następujące wartości: BulletList, List oraz SingleParagraph.
EnableClientScript	Określa czy należy sprawdzać poprawność danych po stronie klienta.
ForeColor	Kolor jakim mają być wyświetlane komunikaty o błędach.
HeaderText	Nagłówek wyświetlany w tym elemencie sterującym.
ShowMessageBox	Określa czy komunikaty o błędach mają być wyświetlane w okienku dialogowym.
ShowSummary	Określa czy podsumowanie wyników kontroli poprawności danych ma być wyświetlane na stronie WWW.

2 Część I ♦ Podstawy obsługi systemu WhizBang (Nagłówek strony)

2 Dokument5

Autor się myli - różnica pomiędzy InnerText i InnerHtml jest ogromna!! Nie kłamał natomiast odnośnie kodowania.

Opis podany przez autora jest błędny (patrz dokumentacja .NET SDK).

Zmieniłem na podstawie tabeli B.35 (analogiczny mechanizm), bo w dokumentacji nie mogłem się doszukać właściwości Command o której pisze autor, która miałaby związek z tymi zdarzeniami. To samo dotyczy dalszych zdarzeń opisanych w tej tabeli.

Na podstawie dokumentacji .NET SDK.

Błąd autora ma być NavigateUrl

Zmieniłem na podstawie dokumentacji .NET SDK.

---