DataList Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Kontrolka listy powiązanej z danymi, która wyświetla elementy przy użyciu szablonów.
public ref class DataList : System::Web::UI::WebControls::BaseDataList, System::Web::UI::INamingContainer, System::Web::UI::WebControls::IRepeatInfoUser
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class DataList : System.Web.UI.WebControls.BaseDataList, System.Web.UI.INamingContainer, System.Web.UI.WebControls.IRepeatInfoUser
type DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUser
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type DataList = class
inherit BaseDataList
interface INamingContainer
interface IRepeatInfoUser
Public Class DataList
Inherits BaseDataList
Implements INamingContainer, IRepeatInfoUser
- Dziedziczenie
- Atrybuty
- Implementuje
Przykłady
W poniższym przykładzie kodu pokazano, jak za pomocą DataList kontrolki wyświetlić listę elementów ze źródła danych.
Uwaga
Poniższy przykładowy kod używa modelu kodu z jednym plikiem i może nie działać poprawnie, jeśli został skopiowany bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem .aspx. Aby uzyskać więcej informacji na temat modelu kodu formularzy internetowych, zobacz ASP.NET Model kodu strony formularzy internetowych.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
ICollection CreateDataSource()
{
// Create sample data for the DataList control.
DataTable dt = new DataTable();
DataRow dr;
// Define the columns of the table.
dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));
// Populate the table with sample values.
for (int i = 0; i < 9; i++)
{
dr = dt.NewRow();
dr[0] = i;
dr[1] = "Description for item " + i.ToString();
dr[2] = 1.23 * (i + 1);
dr[3] = "Image" + i.ToString() + ".jpg";
dt.Rows.Add(dr);
}
DataView dv = new DataView(dt);
return dv;
}
void Page_Load(Object sender, EventArgs e)
{
// Load sample data only once, when the page is first loaded.
if (!IsPostBack)
{
ItemsList.DataSource = CreateDataSource();
ItemsList.DataBind();
}
}
</script>
<head runat="server">
<title>DataList Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList Example</h3>
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
runat="server">
<HeaderStyle BackColor="#aaaadd">
</HeaderStyle>
<AlternatingItemStyle BackColor="Gainsboro">
</AlternatingItemStyle>
<HeaderTemplate>
List of items
</HeaderTemplate>
<ItemTemplate>
Description: <br />
<%# DataBinder.Eval(Container.DataItem, "StringValue") %>
<br />
Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage" AlternateText="Product picture"
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">
Function CreateDataSource() As ICollection
' Create sample data for the DataList control.
Dim dt As DataTable = New DataTable()
dim dr As DataRow
' Define the columns of the table.
dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
dt.Columns.Add(New DataColumn("ImageValue", GetType(String)))
' Populate the table with sample values.
Dim i As Integer
For i = 0 To 8
dr = dt.NewRow()
dr(0) = i
dr(1) = "Description for item " & i.ToString()
dr(2) = 1.23 * (i + 1)
dr(3) = "Image" & i.ToString() & ".jpg"
dt.Rows.Add(dr)
Next i
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Sub Page_Load(sender As Object, e As EventArgs)
' Load sample data only once, when the page is first loaded.
If Not IsPostBack Then
ItemsList.DataSource = CreateDataSource()
ItemsList.DataBind()
End If
End Sub
</script>
<head runat="server">
<title>DataList Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>DataList Example</h3>
<asp:DataList id="ItemsList"
BorderColor="black"
CellPadding="5"
CellSpacing="5"
RepeatDirection="Vertical"
RepeatLayout="Table"
RepeatColumns="3"
runat="server">
<HeaderStyle BackColor="#aaaadd">
</HeaderStyle>
<AlternatingItemStyle BackColor="Gainsboro">
</AlternatingItemStyle>
<HeaderTemplate>
List of items
</HeaderTemplate>
<ItemTemplate>
Description: <br />
<%# DataBinder.Eval(Container.DataItem, "StringValue") %>
<br />
Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>
<br />
<asp:Image id="ProductImage" AlternateText="Product picture"
ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
runat="server"/>
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
Uwagi
W tym temacie:
Wprowadzenie
Użyj kontrolki , DataList aby wyświetlić listę powiązanych danych zdefiniowaną przez szablon. Kontrolka DataList obsługuje wybieranie i edytowanie.
Szablony
Zawartość kontrolki DataList można manipulować za pomocą szablonów. W poniższej tabeli wymieniono obsługiwane szablony.
Nazwa szablonu | Opis |
---|---|
AlternatingItemTemplate | Jeśli jest zdefiniowana, udostępnia zawartość i układ elementów zmiany w elemencie DataList. Jeśli nie zostanie zdefiniowana, ItemTemplate zostanie użyta. |
EditItemTemplate | Jeśli jest zdefiniowana, udostępnia zawartość i układ elementu, który jest obecnie edytowany w elemencie DataList. Jeśli nie zostanie zdefiniowana, ItemTemplate zostanie użyta. |
FooterTemplate | Jeśli jest zdefiniowana, zawiera zawartość i układ sekcji stopki elementu DataList. Jeśli nie zostanie zdefiniowana, sekcja stopki nie zostanie wyświetlona. |
HeaderTemplate | Jeśli jest zdefiniowana, zawiera zawartość i układ sekcji nagłówka .DataList Jeśli nie zostanie zdefiniowana, sekcja nagłówka nie zostanie wyświetlona. |
ItemTemplate | Wymagany szablon, który udostępnia zawartość i układ elementów w obiekcie DataList. |
SelectedItemTemplate | Jeśli jest zdefiniowana, udostępnia zawartość i układ aktualnie wybranego elementu w elemencie DataList. Jeśli nie zostanie zdefiniowana, ItemTemplate zostanie użyta. |
SeparatorTemplate | Jeśli jest zdefiniowana, udostępnia zawartość i układ separatora między elementami w obiekcie DataList. Jeśli nie zostanie zdefiniowany, separator nie będzie wyświetlany. |
Aby wyświetlić elementy w kontrolceDataList, ItemTemplate należy je zdefiniować co najmniej. Dodatkowe szablony mogą służyć do zapewnienia niestandardowego wyglądu kontrolki DataList .
Dostosowywanie wyglądu kontrolki DataList
Wygląd kontrolki DataList można dostosować, ustawiając właściwości stylu dla różnych części kontrolki. W poniższej tabeli wymieniono różne właściwości stylu.
Właściwość stylu | Opis |
---|---|
AlternatingItemStyle | Określa styl zmiany elementów w kontrolce DataList . |
EditItemStyle | Określa styl elementu edytowanego w kontrolce DataList . |
FooterStyle | Określa styl stopki w kontrolce DataList . |
HeaderStyle | Określa styl nagłówka w kontrolce DataList . |
ItemStyle | Określa styl elementów w kontrolce DataList . |
SelectedItemStyle | Określa styl wybranego elementu w kontrolce DataList . |
SeparatorStyle | Określa styl separatora między elementami w kontrolce DataList . |
Możesz również pokazać lub ukryć różne części kontrolki. W poniższej tabeli wymieniono właściwości, które kontrolują, które części są wyświetlane lub ukryte.
Właściwość | Opis |
---|---|
ShowFooter | Pokazuje lub ukrywa sekcję stopki kontrolki DataList . |
ShowHeader | Pokazuje lub ukrywa sekcję nagłówka kontrolki DataList . |
Kierunek wyświetlania i układ
Kierunek wyświetlania DataList kontrolki może być pionowy lub poziomy. Ustaw właściwość , RepeatDirection aby określić kierunek wyświetlania.
Układ kontrolki DataList jest kontrolowany za RepeatLayout pomocą właściwości . Ustawienie tej właściwości tak, aby RepeatLayout.Table
wyświetlała DataList obiekt w formacie tabeli, a właściwość RepeatLayout.Flow
jest wyświetlana DataList bez struktury tabeli.
Zabezpieczenia
Kontrolka DataList
może zawierać kontrolki, które umożliwiają użytkownikom wprowadzanie informacji.
Przestroga
Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, które mogą obejmować złośliwy skrypt klienta. Przed wyświetleniem w aplikacji sprawdź informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu. Kontrolki weryfikacji umożliwiają zweryfikowanie danych wejściowych użytkownika przed wyświetleniem tekstu wejściowego w kontrolce. ASP.NET udostępnia funkcję weryfikacji żądania wejściowego w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika.
Aby uzyskać więcej informacji na temat zabezpieczeń, zobacz Zabezpieczanie standardowych kontrolek, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings (Zabezpieczanie standardowych mechanizmów kontroli), How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings (Zabezpieczanie standardowych kontrolek: ochrona przed programami wykorzystującymi luki w zabezpieczeniach skryptów w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów) i Weryfikowanie danych wejściowych użytkownika na stronach sieci Web ASP.NET.
Składnia deklaracyjna
<asp:DataList
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DataKeyField="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
EditItemIndex="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ExtractTemplateRows="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
GridLines="None|Horizontal|Vertical|Both"
Height="size"
HorizontalAlign="NotSet|Left|Center|Right|Justify"
ID="string"
OnCancelCommand="CancelCommand event handler"
OnDataBinding="DataBinding event handler"
OnDeleteCommand="DeleteCommand event handler"
OnDisposed="Disposed event handler"
OnEditCommand="EditCommand event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDataBound="ItemDataBound event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnUnload="Unload event handler"
OnUpdateCommand="UpdateCommand event handler"
RepeatColumns="integer"
RepeatDirection="Horizontal|Vertical"
RepeatLayout="Table|Flow"
runat="server"
SelectedIndex="integer"
ShowFooter="True|False"
ShowHeader="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
Width="size"
>
<AlternatingItemStyle />
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<EditItemStyle />
<EditItemTemplate>
<!-- child controls -->
</EditItemTemplate>
<FooterStyle />
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderStyle />
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<ItemStyle />
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<SelectedItemStyle />
<SelectedItemTemplate>
<!-- child controls -->
</SelectedItemTemplate>
<SeparatorStyle />
<SeparatorTemplate>
<!-- child controls -->
</SeparatorTemplate>
</asp:DataList>
Konstruktory
DataList() |
Inicjuje nowe wystąpienie klasy DataList. |
Pola
CancelCommandName |
|
DeleteCommandName |
|
EditCommandName |
|
SelectCommandName |
|
UpdateCommandName |
|
Właściwości
AccessKey |
Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl) |
Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
AlternatingItemStyle |
Pobiera właściwości stylu dla elementów zmiany w kontrolce DataList . |
AlternatingItemTemplate |
Pobiera lub ustawia szablon do zmiany elementów w elemencie DataList. |
AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
Attributes |
Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl) |
BackColor |
Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control) |
BorderColor |
Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl) |
BorderStyle |
Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
BorderWidth |
Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
Caption |
Pobiera lub ustawia tekst do renderowania w elemecie podpisu HTML w kontrolce. Ta właściwość jest udostępniana w celu zwiększenia dostępności kontroli dla użytkowników urządzeń z technologią pomocniczą. (Odziedziczone po BaseDataList) |
CaptionAlign |
Pobiera lub ustawia położenie w poziomie lub w pionie elementu podpisu HTML w kontrolce. Ta właściwość jest udostępniana w celu zwiększenia dostępności kontroli dla użytkowników urządzeń z technologią pomocniczą. (Odziedziczone po BaseDataList) |
CellPadding |
Pobiera lub ustawia ilość miejsca między zawartością komórki a obramowaniem komórki. (Odziedziczone po BaseDataList) |
CellSpacing |
Pobiera lub ustawia ilość miejsca między komórkami. (Odziedziczone po BaseDataList) |
ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control) |
ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości. (Odziedziczone po Control) |
ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
Controls |
ControlCollection Pobiera obiekt, który zawiera kolekcję kontrolek podrzędnych w kontrolce listy danych. (Odziedziczone po BaseDataList) |
ControlStyle |
Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
ControlStyleCreated |
Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości . Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
CssClass |
Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl) |
DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
DataKeyField |
Pobiera lub ustawia pole klucza w źródle danych określonym przez DataSource właściwość . (Odziedziczone po BaseDataList) |
DataKeys |
DataKeyCollection Pobiera obiekt, który przechowuje wartości kluczy każdego rekordu w kontrolce listy danych. (Odziedziczone po BaseDataList) |
DataKeysArray |
ArrayList Pobiera obiekt zawierający wartości klucza każdego rekordu w kontrolce listy danych. (Odziedziczone po BaseDataList) |
DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
DataMember |
Pobiera lub ustawia określony element członkowski danych w źródle danych wieloczłonowych w celu powiązania z kontrolką listy danych. (Odziedziczone po BaseDataList) |
DataSource |
Pobiera lub ustawia źródło zawierające listę wartości używanych do wypełniania elementów w kontrolce. (Odziedziczone po BaseDataList) |
DataSourceID |
Pobiera lub ustawia ID właściwość kontrolki źródła danych, która powinna być używana przez kontrolkę listy danych w celu pobrania źródła danych. (Odziedziczone po BaseDataList) |
DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
EditItemIndex |
Pobiera lub ustawia numer indeksu wybranego elementu w kontrolce do edycji DataList . |
EditItemStyle |
Pobiera właściwości stylu elementu wybranego do edycji w kontrolce DataList . |
EditItemTemplate |
Pobiera lub ustawia szablon elementu wybranego do edycji w kontrolce DataList . |
Enabled |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl) |
EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl) |
EnableViewState |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control) |
Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
ExtractTemplateRows |
Pobiera lub ustawia wartość wskazującą, czy wiersze Table kontrolki zdefiniowane w każdym szablonie DataList kontrolki są wyodrębniane i wyświetlane. |
Font |
Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl) |
FooterStyle |
Pobiera właściwości stylu dla sekcji stopki kontrolki DataList . |
FooterTemplate |
Pobiera lub ustawia szablon sekcji stopki kontrolki DataList . |
ForeColor |
Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
GridLines |
Pobiera lub ustawia styl linii siatki dla kontrolki DataList , gdy właściwość jest ustawiona RepeatLayout na |
HasAttributes |
Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl) |
HasChildViewState |
Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
HeaderStyle |
Pobiera właściwości stylu dla sekcji nagłówka kontrolki DataList . |
HeaderTemplate |
Pobiera lub ustawia szablon sekcji nagłówka kontrolki DataList . |
Height |
Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
HorizontalAlign |
Pobiera lub ustawia wyrównanie w poziomie kontrolki listy danych w kontenerze. (Odziedziczone po BaseDataList) |
ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
Initialized |
Pobiera wartość wskazującą, czy kontrolka została zainicjowana. (Odziedziczone po BaseDataList) |
IsBoundUsingDataSourceID |
Pobiera wartość wskazującą, czy właściwość jest ustawiona DataSourceID . (Odziedziczone po BaseDataList) |
IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
IsEnabled |
Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl) |
IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
IsViewStateEnabled |
Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control) |
Items |
Pobiera kolekcję DataListItem obiektów reprezentujących poszczególne elementy w kontrolce. |
ItemStyle |
Pobiera właściwości stylu dla elementów w kontrolce DataList . |
ItemTemplate |
Pobiera lub ustawia szablon dla elementów w kontrolce DataList . |
LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control) |
NamingContainer |
Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control) |
Page |
Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control) |
Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control) |
RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
RepeatColumns |
Pobiera lub ustawia liczbę kolumn do wyświetlenia w kontrolce DataList . |
RepeatDirection |
Pobiera lub ustawia, czy kontrolka DataList jest wyświetlana w pionie, czy w poziomie. |
RepeatLayout |
Pobiera lub ustawia, czy kontrolka jest wyświetlana w układzie tabeli lub przepływu. |
RequiresDataBinding |
Pobiera lub ustawia wartość wskazującą, czy kontrolka listy danych musi być powiązana z określonym źródłem danych. (Odziedziczone po BaseDataList) |
SelectArguments |
Pobiera obiekt używany przez kontrolkę DataSourceSelectArguments związaną z danymi podczas pobierania danych z kontrolki źródła danych. (Odziedziczone po BaseDataList) |
SelectedIndex |
Pobiera lub ustawia indeks wybranego elementu w kontrolce DataList . |
SelectedItem |
Pobiera wybrany element w kontrolce DataList . |
SelectedItemStyle |
Pobiera właściwości stylu dla wybranego elementu w kontrolce DataList . |
SelectedItemTemplate |
Pobiera lub ustawia szablon dla wybranego elementu w kontrolce DataList . |
SelectedValue |
Pobiera wartość pola klucza dla wybranego elementu listy danych. |
SeparatorStyle |
Pobiera właściwości stylu separatora między poszczególnymi elementami w kontrolce DataList . |
SeparatorTemplate |
Pobiera lub ustawia szablon separatora między elementami kontrolki DataList . |
ShowFooter |
Pobiera lub ustawia wartość wskazującą, czy sekcja stopki jest wyświetlana w kontrolce DataList . |
ShowHeader |
Pobiera lub ustawia wartość wskazującą, czy sekcja nagłówka jest wyświetlana w kontrolce DataList . |
Site |
Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
SkinID |
Pobiera lub ustawia skórę do zastosowania w kontrolce. (Odziedziczone po WebControl) |
Style |
Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu w zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
SupportsDisabledAttribute |
Pobiera wartość wskazującą, czy kontrolka powinna ustawić |
TabIndex |
Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
TagKey |
Pobiera tag HTML używany do renderowania kontrolki DataList . |
TagKey |
Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontrolce serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
TagName |
Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
TemplateSourceDirectory |
Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
ToolTip |
Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl) |
UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
UseAccessibleHeader |
Pobiera lub ustawia wartość wskazującą, czy kontrolka listy danych renderuje nagłówek w dostępnym formacie. Ta właściwość jest udostępniana w celu zwiększenia dostępności kontroli dla użytkowników urządzeń z technologią pomocniczą. (Odziedziczone po BaseDataList) |
ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
ViewState |
Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter. (Odziedziczone po Control) |
ViewStateMode |
Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control) |
Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control) |
Width |
Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
Metody
AddAttributesToRender(HtmlTextWriter) |
Dodaje atrybuty i style HTML, które należy renderować do określonego HtmlTextWriterTagelementu . Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
AddedControl(Control, Int32) |
Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
AddParsedSubObject(Object) |
Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do kolekcji kontrolki ControlCollection serwera. (Odziedziczone po BaseDataList) |
ApplyStyle(Style) |
Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
BuildProfileTree(String, Boolean) |
Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control) |
ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
ClearChildControlState() |
Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearChildState() |
Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit. (Odziedziczone po Control) |
CopyBaseAttributes(WebControl) |
Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
CreateChildControls() |
Tworzy kontrolkę podrzędną przy użyciu stanu widoku. (Odziedziczone po BaseDataList) |
CreateControlCollection() |
Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera. (Odziedziczone po Control) |
CreateControlHierarchy(Boolean) |
Tworzy hierarchię sterowania używaną do renderowania kontrolki listy danych z określonym źródłem danych lub bez tego źródła. |
CreateControlStyle() |
Tworzy domyślny obiekt stylu używany wewnętrznie przez kontrolkę DataList do implementowania wszystkich właściwości powiązanych ze stylem. |
CreateDataSourceSelectArguments() |
Tworzy obiekt domyślny DataSourceSelectArguments używany przez kontrolkę związaną z danymi, jeśli nie określono żadnych argumentów. (Odziedziczone po BaseDataList) |
CreateItem(Int32, ListItemType) |
Tworzy obiekt DataListItem. |
DataBind() |
Tworzy powiązanie kontrolki i wszystkich jej kontrolek podrzędnych z określonym źródłem danych. (Odziedziczone po BaseDataList) |
DataBind(Boolean) |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding . (Odziedziczone po Control) |
DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
Dispose() |
Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
EndRenderTracing(TextWriter, Object) |
Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
EnsureDataBound() |
Sprawdza, czy kontrolka wyświetlania listy danych wymaga powiązania danych i czy przed wywołaniem metody określono prawidłową DataBind() kontrolę źródła danych. (Odziedziczone po BaseDataList) |
EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
FindControl(String) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego |
FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
Focus() |
Ustawia fokus wejściowy na kontrolkę. (Odziedziczone po Control) |
GetData() |
IEnumerableZwraca obiekt implementowany, który reprezentuje źródło danych. (Odziedziczone po BaseDataList) |
GetDesignModeState() |
Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
InitializeItem(DataListItem) |
Inicjuje DataListItem obiekt na podstawie określonych szablonów i stylów dla typu elementu listy. |
IsLiteralContent() |
Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control) |
LoadControlState(Object) |
Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control) |
LoadViewState(Object) |
Ładuje wcześniej zapisany stan widoku kontrolki DataList . |
MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
MergeStyle(Style) |
Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
OnBubbleEvent(Object, EventArgs) |
Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. |
OnCancelCommand(DataListCommandEventArgs) |
CancelCommand Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnDataBinding(EventArgs) |
DataBinding Wywołuje zdarzenie kontrolkiBaseDataList. (Odziedziczone po BaseDataList) |
OnDataPropertyChanged() |
Wywoływana po zmianie jednej z właściwości identyfikacji podstawowego źródła danych w celu ponownego powiązania kontrolki powiązanej z danymi. (Odziedziczone po BaseDataList) |
OnDataSourceViewChanged(Object, EventArgs) |
DataSourceViewChanged Zgłasza zdarzenie. (Odziedziczone po BaseDataList) |
OnDeleteCommand(DataListCommandEventArgs) |
DeleteCommand Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnEditCommand(DataListCommandEventArgs) |
EditCommand Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnInit(EventArgs) | |
OnInit(EventArgs) |
Init Zgłasza zdarzenie dla kontrolkiBaseDataList. (Odziedziczone po BaseDataList) |
OnItemCommand(DataListCommandEventArgs) |
ItemCommand Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnItemCreated(DataListItemEventArgs) |
ItemCreated Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnItemDataBound(DataListItemEventArgs) |
ItemDataBound Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po BaseDataList) |
OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie. (Odziedziczone po BaseDataList) |
OnSelectedIndexChanged(EventArgs) |
SelectedIndexChanged Wywołuje zdarzenie kontrolkiBaseDataList. (Odziedziczone po BaseDataList) |
OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
OnUpdateCommand(DataListCommandEventArgs) |
UpdateCommand Zgłasza zdarzenie. Dzięki temu można podać niestandardową procedurę obsługi dla zdarzenia. |
OpenFile(String) |
Stream Pobiera element używany do odczytywania pliku. (Odziedziczone po Control) |
PrepareControlHierarchy() |
Przygotowuje hierarchię kontrolek do renderowania w kontrolce DataList . |
RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu. (Odziedziczone po Control) |
Render(HtmlTextWriter) |
Renderuje kontrolkę dla określonego składnika zapisywania HTML. (Odziedziczone po BaseDataList) |
RenderBeginTag(HtmlTextWriter) |
Renderuje tag otwierania HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
RenderChildren(HtmlTextWriter) |
Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
RenderContents(HtmlTextWriter) |
Renderuje elementy listy w kontrolce DataList . |
RenderControl(HtmlTextWriter) |
Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control) |
RenderEndTag(HtmlTextWriter) |
Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
ResolveAdapter() |
Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
SaveViewState() |
Zapisuje zmiany stanu widoku sterowania od czasu opublikowania strony z powrotem na serwerze. |
SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control) |
SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
SetTraceData(Object, Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
TrackViewState() |
Śledzi zmiany stanu widoku w kontrolce DataList , aby można je było przechowywać we właściwości kontrolki ViewState . |
Zdarzenia
CancelCommand |
Występuje po kliknięciu |
DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
DeleteCommand |
Występuje po kliknięciu |
Disposed |
Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET. (Odziedziczone po Control) |
EditCommand |
Występuje po kliknięciu |
Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
ItemCommand |
Występuje po kliknięciu dowolnego przycisku w kontrolce DataList . |
ItemCreated |
Występuje na serwerze po utworzeniu elementu w kontrolce DataList . |
ItemDataBound |
Występuje, gdy element jest danymi powiązanymi z kontrolką DataList . |
Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
SelectedIndexChanged |
Występuje, gdy inny element jest wybierany w kontrolce listy danych między wpisami na serwerze. (Odziedziczone po BaseDataList) |
Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
UpdateCommand |
Występuje po kliknięciu |
Jawne implementacje interfejsu
Metody rozszerzania
FindDataSourceControl(Control) |
Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki. |
FindFieldTemplate(Control, String) |
Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki. |
FindMetaTable(Control) |
Zwraca obiekt metatable dla kontrolki zawierającej dane. |
GetDefaultValues(INamingContainer) |
Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych. |
GetMetaTable(INamingContainer) |
Pobiera metadane tabeli dla określonej kontrolki danych. |
SetMetaTable(INamingContainer, MetaTable) |
Ustawia metadane tabeli dla określonej kontrolki danych. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
TryGetMetaTable(INamingContainer, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
EnableDynamicData(INamingContainer, Type) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
EnableDynamicData(INamingContainer, Type, Object) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
Dotyczy
Zobacz też
- BaseDataList
- DataGrid
- Repeater
- Zabezpieczanie kontrolek standardowych
- Instrukcje: ochrona przed programami wykorzystującymi luki w zabezpieczeniach skryptów w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów
- Weryfikowanie danych wejściowych użytkownika w usłudze ASP.NET Web Pages
- model kodu strony internetowej ASP.NET