DataList Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Ovládací prvek seznamu vázaného na data, který zobrazuje položky pomocí šablon.
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
- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklad kódu ukazuje použití DataList ovládacího prvku k zobrazení seznamu položek ze zdroje dat.
Poznámka:
Následující ukázka kódu používá model kódu s jedním souborem a při kopírování přímo do souboru s kódem nemusí správně fungovat. Tento vzorový kód musí být zkopírován do prázdného textového souboru, který má příponu .aspx. Další informace o modelu kódu webového formuláře najdete v tématu ASP.NET model kódu stránky webového formuláře.
<%@ 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>
Poznámky
V tomto tématu:
Introduction
DataList Pomocí ovládacího prvku zobrazíte seznam svázaných dat definovaný šablonou. Ovládací DataList prvek podporuje výběr a úpravy.
Šablony
DataList Obsah ovládacího prvku lze manipulovat pomocí šablon. V následující tabulce jsou uvedené podporované šablony.
| Název šablony | Description |
|---|---|
| AlternatingItemTemplate | Pokud je definováno, poskytuje obsah a rozložení pro střídavé položky v objektu DataList. Pokud není definováno, ItemTemplate použije se. |
| EditItemTemplate | Pokud je definováno, poskytuje obsah a rozložení pro položku, která se právě upravuje v souboru DataList. Pokud není definováno, ItemTemplate použije se. |
| FooterTemplate | Pokud je definováno, poskytuje obsah a rozložení pro oddíl zápatí v objektu DataList. Pokud není definovaný, oddíl zápatí se nezobrazí. |
| HeaderTemplate | Pokud je definováno, poskytuje obsah a rozložení pro oddíl záhlaví oddílu DataList. Pokud není definovaný, oddíl záhlaví se nezobrazí. |
| ItemTemplate | Požadovaná šablona, která poskytuje obsah a rozložení položek v souboru DataList. |
| SelectedItemTemplate | Pokud je definováno, poskytuje obsah a rozložení aktuálně vybrané položky v souboru DataList. Pokud není definováno, ItemTemplate použije se. |
| SeparatorTemplate | Pokud je definováno, poskytuje obsah a rozložení oddělovače mezi položkami v objektu DataList. Pokud není definován, oddělovač se nezobrazí. |
Na minimum je potřeba definovat, ItemTemplate aby se zobrazily položky v ovládacím DataList prvku. Další šablony lze použít k poskytnutí vlastního vzhledu DataList ovládacího prvku.
Přizpůsobení vzhledu ovládacího prvku DataList
DataList Vzhled ovládacího prvku lze přizpůsobit nastavením vlastností stylu pro různé části ovládacího prvku. Následující tabulka uvádí různé vlastnosti stylu.
| Vlastnost stylu | Description |
|---|---|
| AlternatingItemStyle | Určuje styl střídavých položek v ovládacím DataList prvku. |
| EditItemStyle | Určuje styl upravované položky v ovládacím DataList prvku. |
| FooterStyle | Určuje styl zápatí v ovládacím DataList prvku. |
| HeaderStyle | Určuje styl záhlaví DataList ovládacího prvku. |
| ItemStyle | Určuje styl položek v ovládacím DataList prvku. |
| SelectedItemStyle | Určuje styl vybrané položky v ovládacím DataList prvku. |
| SeparatorStyle | Určuje styl oddělovače mezi položkami v ovládacím DataList prvku. |
Můžete také zobrazit nebo skrýt různé části ovládacího prvku. Následující tabulka uvádí vlastnosti, které určují, které části jsou zobrazeny nebo skryté.
| Vlastnictví | Description |
|---|---|
| ShowFooter | Zobrazí nebo skryje část DataList zápatí ovládacího prvku. |
| ShowHeader | Zobrazí nebo skryje oddíl DataList záhlaví ovládacího prvku. |
Směr zobrazení a rozložení
Směr DataList zobrazení ovládacího prvku může být svislý nebo vodorovný. RepeatDirection Nastavte vlastnost tak, aby určil směr zobrazení.
Rozložení DataList ovládacího prvku je řízeno RepeatLayout vlastností. Nastavením této vlastnosti RepeatLayout.Table se zobrazí DataList ve formátu tabulky, zatímco RepeatLayout.Flow se zobrazí DataList bez struktury tabulky.
Zabezpečení
Ovládací DataList prvek může obsahovat ovládací prvky, které uživatelům umožňují zadávat informace.
Upozornění
Tento ovládací prvek lze použít k zobrazení vstupu uživatele, který může obsahovat škodlivý klientský skript. Před zobrazením v aplikaci zkontrolujte všechny informace odeslané z klienta pro spustitelný skript, příkazy SQL nebo jiný kód. Ověřovací ovládací prvky můžete použít k ověření uživatelského vstupu před zobrazením vstupního textu v ovládacím prvku. ASP.NET poskytuje funkci ověřování vstupních požadavků pro blokování skriptu a kódu HTML ve vstupu uživatele.
Další informace o zabezpečení naleznete v tématu Zabezpečení standardních ovládacích prvků, Postupy: Ochrana před zneužitím skriptů ve webové aplikaci použitím kódování HTML na řetězce a ověřování uživatelského vstupu na ASP.NET webových stránek.
Deklarativní syntaxe
<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
| Name | Description |
|---|---|
| DataList() |
Inicializuje novou instanci DataList třídy. |
Pole
| Name | Description |
|---|---|
| CancelCommandName |
|
| DeleteCommandName |
|
| EditCommandName |
|
| SelectCommandName |
|
| UpdateCommandName |
|
Vlastnosti
| Name | Description |
|---|---|
| AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AlternatingItemStyle |
Získá vlastnosti stylu pro střídavé položky v ovládacím DataList prvku. |
| AlternatingItemTemplate |
Získá nebo nastaví šablonu pro střídavé položky v souboru DataList. |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control) |
| BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
| BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| Caption |
Získá nebo nastaví text, který se má vykreslit v elementu titulku HTML v ovládacím prvku. Tato vlastnost je poskytována, aby byl ovládací prvek přístupnější uživatelům zařízení technologie usnadnění. (Zděděno od BaseDataList) |
| CaptionAlign |
Získá nebo nastaví vodorovnou nebo svislou pozici elementu titulku HTML v ovládacím prvku. Tato vlastnost je poskytována, aby byl ovládací prvek přístupnější uživatelům zařízení technologie usnadnění. (Zděděno od BaseDataList) |
| CellPadding |
Získá nebo nastaví velikost mezery mezi obsahem buňky a ohraničením buňky. (Zděděno od BaseDataList) |
| CellSpacing |
Získá nebo nastaví velikost mezery mezi buňkami. (Zděděno od BaseDataList) |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
| ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
| ClientIDSeparator |
Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
| Controls |
ControlCollection Získá objekt, který obsahuje kolekci podřízených ovládacích prvků v ovládacím prvku výpis dat. (Zděděno od BaseDataList) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu určující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CssClass |
Získá nebo nastaví cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl) |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeyField |
Získá nebo nastaví pole klíče ve zdroji dat určeném DataSource vlastností. (Zděděno od BaseDataList) |
| DataKeys |
DataKeyCollection Získá objekt, který ukládá klíčové hodnoty každého záznamu v ovládacím prvku výpis dat. (Zděděno od BaseDataList) |
| DataKeysArray |
ArrayList Získá objekt, který obsahuje klíčové hodnoty každého záznamu v ovládacím prvku výpis dat. (Zděděno od BaseDataList) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DataMember |
Získá nebo nastaví konkrétního datového člena ve vícečlenovém zdroji dat pro vazbu s ovládacím prvek výpisu dat. (Zděděno od BaseDataList) |
| DataSource |
Získá nebo nastaví zdroj obsahující seznam hodnot použitých k naplnění položek v ovládacím prvku. (Zděděno od BaseDataList) |
| DataSourceID |
Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který má ovládací prvek výpisu dat použít k načtení jeho zdroje dat. (Zděděno od BaseDataList) |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| EditItemIndex |
Získá nebo nastaví číslo indexu vybrané položky v ovládacím DataList prvku pro úpravy. |
| EditItemStyle |
Získá vlastnosti stylu pro položku vybranou pro úpravy v ovládacím DataList prvku. |
| EditItemTemplate |
Získá nebo nastaví šablonu pro položku vybranou pro úpravy v ovládacím DataList prvku. |
| Enabled |
Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl) |
| EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| ExtractTemplateRows |
Získá nebo nastaví hodnotu, která určuje, zda řádky Table ovládacího prvku definované v každé šabloně DataList ovládacího prvku jsou extrahovány a zobrazeny. |
| Font |
Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl) |
| FooterStyle |
Získá vlastnosti stylu pro oddíl DataList zápatí ovládacího prvku. |
| FooterTemplate |
Získá nebo nastaví šablonu pro oddíl DataList zápatí ovládacího prvku. |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| GridLines |
Získá nebo nastaví styl čáry mřížky DataList pro ovládací prvek, když RepeatLayout je vlastnost nastavena na |
| HasAttributes |
Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| HasChildViewState |
Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| HeaderStyle |
Získá vlastnosti stylu pro oddíl nadpisu DataList ovládacího prvku. |
| HeaderTemplate |
Získá nebo nastaví šablonu pro oddíl nadpisu DataList ovládacího prvku. |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HorizontalAlign |
Získá nebo nastaví vodorovné zarovnání ovládacího prvku výpisu dat v rámci jeho kontejneru. (Zděděno od BaseDataList) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| Initialized |
Získá hodnotu označující, zda byl ovládací prvek inicializován. (Zděděno od BaseDataList) |
| IsBoundUsingDataSourceID |
Získá hodnotu určující, zda DataSourceID je vlastnost nastavena. (Zděděno od BaseDataList) |
| IsChildControlStateCleared |
Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| Items |
Získá kolekci DataListItem objektů představujících jednotlivé položky v ovládacím prvku. |
| ItemStyle |
Získá vlastnosti stylu pro položky v ovládacím DataList prvku. |
| ItemTemplate |
Získá nebo nastaví šablonu pro položky v ovládacím DataList prvku. |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| RepeatColumns |
Získá nebo nastaví počet sloupců, které se mají zobrazit v ovládacím DataList prvku. |
| RepeatDirection |
Získá nebo nastaví, zda DataList ovládací prvek zobrazí svisle nebo vodorovně. |
| RepeatLayout |
Získá nebo nastaví, zda je ovládací prvek zobrazen v tabulce nebo rozložení toku. |
| RequiresDataBinding |
Získá nebo nastaví hodnotu určující, zda ovládací prvek výpisu dat musí svázat s jeho zadaným zdrojem dat. (Zděděno od BaseDataList) |
| SelectArguments |
DataSourceSelectArguments Získá objekt, který ovládací prvek vázané na data používá při načítání dat z ovládacího prvku zdroje dat. (Zděděno od BaseDataList) |
| SelectedIndex |
Získá nebo nastaví index vybrané položky v ovládacím DataList prvku. |
| SelectedItem |
Získá vybranou položku v ovládacím DataList prvku. |
| SelectedItemStyle |
Získá vlastnosti stylu pro vybranou položku v ovládacím DataList prvku. |
| SelectedItemTemplate |
Získá nebo nastaví šablonu pro vybranou položku v ovládacím DataList prvku. |
| SelectedValue |
Získá hodnotu pole klíče pro vybranou položku seznamu dat. |
| SeparatorStyle |
Získá vlastnosti stylu oddělovače mezi každou položkou v ovládacím DataList prvku. |
| SeparatorTemplate |
Získá nebo nastaví šablonu oddělovače mezi položkami DataList ovládacího prvku. |
| ShowFooter |
Získá nebo nastaví hodnotu určující, zda je oddíl zápatí zobrazen v ovládacím DataList prvku. |
| ShowHeader |
Získá nebo nastaví hodnotu určující, zda je oddíl záhlaví zobrazen v ovládacím DataList prvku. |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od WebControl) |
| Style |
Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která určuje, zda ovládací prvek má nastavit |
| TabIndex |
Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
Získá HTML značku, která se používá k vykreslení DataList ovládacího prvku. |
| TagKey |
Získá hodnotu, která odpovídá tomuto ovládacímu HtmlTextWriterTag prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
| TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control) |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| UseAccessibleHeader |
Získá nebo nastaví hodnotu určující, zda ovládací prvek výpisu dat vykresluje jeho záhlaví v přístupném formátu. Tato vlastnost je poskytována, aby byl ovládací prvek přístupnější uživatelům zařízení technologie usnadnění. (Zděděno od BaseDataList) |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
Metody
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je třeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
| AddParsedSubObject(Object) |
Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do kolekce ovládacího prvku ControlCollection serveru. (Zděděno od BaseDataList) |
| ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| CreateChildControls() |
Vytvoří podřízený ovládací prvek pomocí stavu zobrazení. (Zděděno od BaseDataList) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control) |
| CreateControlHierarchy(Boolean) |
Vytvoří hierarchii ovládacích prvků, která se používá k vykreslení ovládacího prvku seznamu dat se zadaným zdrojem dat nebo bez. |
| CreateControlStyle() |
Vytvoří výchozí objekt stylu, který ovládací prvek interně DataList používá k implementaci všech vlastností souvisejících se stylem. |
| CreateDataSourceSelectArguments() |
Vytvoří výchozí DataSourceSelectArguments objekt, který používá ovládací prvek vázané na data, pokud nejsou zadány žádné argumenty. (Zděděno od BaseDataList) |
| CreateItem(Int32, ListItemType) |
DataListItem Vytvoří objekt. |
| DataBind() |
Vytvoří vazbu ovládacího prvku a všech jeho podřízených ovládacích prvků na zadaný zdroj dat. (Zděděno od BaseDataList) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureDataBound() |
Ověřuje, že ovládací prvek výpisu dat vyžaduje datovou vazbu a zda je před voláním DataBind() metody zadán platný ovládací prvek zdroje dat. (Zděděno od BaseDataList) |
| EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control) |
| GetData() |
Vrátí -implementovaný IEnumerableobjekt, který představuje zdroj dat. (Zděděno od BaseDataList) |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| InitializeItem(DataListItem) |
Inicializuje DataListItem objekt na základě zadaných šablon a stylů pro typ položky seznamu. |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control) |
| LoadViewState(Object) |
Načte dříve uložený stav DataList zobrazení ovládacího prvku. |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. |
| OnCancelCommand(DataListCommandEventArgs) |
CancelCommand Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost BaseDataList ovládacího prvku. (Zděděno od BaseDataList) |
| OnDataPropertyChanged() |
Volá se, když se změní jedna z vlastností identifikace základního zdroje dat, aby bylo možné znovu vytvořit vazbu ovládacího prvku vázaného na data. (Zděděno od BaseDataList) |
| OnDataSourceViewChanged(Object, EventArgs) |
DataSourceViewChanged Vyvolá událost. (Zděděno od BaseDataList) |
| OnDeleteCommand(DataListCommandEventArgs) |
DeleteCommand Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnEditCommand(DataListCommandEventArgs) |
EditCommand Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnInit(EventArgs) | |
| OnItemCommand(DataListCommandEventArgs) |
ItemCommand Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnItemCreated(DataListItemEventArgs) |
ItemCreated Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnItemDataBound(DataListItemEventArgs) |
ItemDataBound Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od BaseDataList) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. (Zděděno od BaseDataList) |
| OnSelectedIndexChanged(EventArgs) |
SelectedIndexChanged Vyvolá událost BaseDataList ovládacího prvku. (Zděděno od BaseDataList) |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OnUpdateCommand(DataListCommandEventArgs) |
UpdateCommand Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. |
| OpenFile(String) |
Stream Získá použité ke čtení souboru. (Zděděno od Control) |
| PrepareControlHierarchy() |
Připraví hierarchii ovládacích prvků pro vykreslení v ovládacím DataList prvku. |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Vykreslí ovládací prvek na zadaný zapisovač HTML. (Zděděno od BaseDataList) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí počáteční značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderContents(HtmlTextWriter) |
Vykreslí položky seznamu v ovládacím DataList prvku. |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| ResolveAdapter() |
Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží změny do stavu zobrazení ovládacího prvku od doby, kdy byla stránka odeslána zpět na server. |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Sleduje změny DataList stavu zobrazení ovládacího prvku, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState . |
Událost
| Name | Description |
|---|---|
| CancelCommand |
Nastane při kliknutí na |
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| DeleteCommand |
Nastane při kliknutí na |
| Disposed |
Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control) |
| EditCommand |
Nastane při kliknutí na |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| ItemCommand |
Nastane při kliknutí na libovolné tlačítko v ovládacím DataList prvku. |
| ItemCreated |
Nastane na serveru při vytvoření položky v ovládacím DataList prvku. |
| ItemDataBound |
Nastane, když je položka vázána na DataList ovládací prvek. |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| SelectedIndexChanged |
Nastane, když je v ovládacím prvku výpisu dat vybrána jiná položka mezi příspěvky na server. (Zděděno od BaseDataList) |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
| UpdateCommand |
Nastane při kliknutí na |
Explicitní implementace rozhraní
Metody rozšíření
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type, Object) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný ovládací prvek dat. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, zda jsou k dispozici metadata tabulky. |