DataList Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

En databunden listkontroll som visar objekt med hjälp av mallar.

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

Arv: Object

Control

WebControl

BaseDataList
DataList

Attribut: ControlValuePropertyAttribute

Implementeringar: INamingContainer IRepeatInfoUser

Exempel

I följande kodexempel visas hur du använder en DataList kontroll för att visa en lista över objekt från en datakälla.

Note

Följande kodexempel använder kodmodellen med en fil och kanske inte fungerar korrekt om den kopieras direkt till en kod bakom-fil. Det här kodexemplet måste kopieras till en tom textfil som har ett .aspx-tillägg. Mer information om kodmodellen Web Forms finns i ASP.NET Web Forms Page Code Model.


<%@ 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>

Kommentarer

I det här avsnittet:

Inledning
Templates
Anpassa utseendet på datalistekontrollen
Visningsriktning och layout
Security
Deklarativ syntax

Introduction

Använd kontrollen DataList för att visa en malldefinierad databunden lista. Kontrollen DataList stöder val och redigering.

Templates

Innehållet i DataList kontrollen kan ändras med hjälp av mallar. I följande tabell visas de mallar som stöds.

Mallnamn	Description
AlternatingItemTemplate	Om det definieras tillhandahåller du innehållet och layouten för att växla objekt i DataList. Om det inte har definierats `ItemTemplate` används.
EditItemTemplate	Om det definieras tillhandahåller du innehållet och layouten för det objekt som för närvarande redigeras i DataList. Om det inte har definierats `ItemTemplate` används.
FooterTemplate	Om det definieras tillhandahåller du innehållet och layouten för sidfotsavsnittet i DataList. Om det inte har definierats visas inte ett sidfotsavsnitt.
HeaderTemplate	Om det definieras tillhandahåller du innehållet och layouten för rubrikavsnittet i DataList. Om det inte har definierats visas inte något rubrikavsnitt.
ItemTemplate	Obligatorisk mall som tillhandahåller innehåll och layout för objekt i DataList.
SelectedItemTemplate	Om det definieras tillhandahåller innehållet och layouten för det markerade objektet i DataList. Om det inte har definierats ItemTemplate används.
SeparatorTemplate	Om det definieras anger du innehållet och layouten för avgränsaren mellan objekten DataListi . Om den inte har definierats visas ingen avgränsare.

Som minst ItemTemplate måste du definiera för att visa objekten DataList i kontrollen. Ytterligare mallar kan användas för att ge kontrollen ett anpassat utseende DataList .

Anpassa utseendet på datalistekontrollen

Kontrollens DataList utseende kan anpassas genom att ange formategenskaperna för de olika delarna av kontrollen. I följande tabell visas de olika stilegenskaperna.

Formategenskap	Description
AlternatingItemStyle	Anger formatmallen för att växla objekt i DataList kontrollen.
EditItemStyle	Anger formatmallen för objektet som redigeras i DataList kontrollen.
FooterStyle	Anger formatet för sidfoten DataList i kontrollen.
HeaderStyle	Anger formatet för rubriken i DataList kontrollen.
ItemStyle	Anger formatmallen för objekten DataList i kontrollen.
SelectedItemStyle	Anger formatmallen för det markerade objektet i DataList kontrollen.
SeparatorStyle	Anger formatet för avgränsaren mellan objekten DataList i kontrollen.

Du kan också visa eller dölja olika delar av kontrollen. I följande tabell visas de egenskaper som styr vilka delar som visas eller döljs.

Fastighet	Description
ShowFooter	Visar eller döljer sidfotsavsnittet i DataList kontrollen.
ShowHeader	Visar eller döljer rubrikavsnittet i DataList kontrollen.

Visningsriktning och layout

Visningsriktningen för en DataList kontroll kan vara lodrät eller vågrät. RepeatDirection Ange egenskapen för att ange visningsriktningen.

Kontrollens DataList layout styrs med RepeatLayout egenskapen . Om du anger den här egenskapen till RepeatLayout.Table visas den DataList i tabellformat, medan RepeatLayout.FlowDataList utan tabellstruktur visas.

Security

Kontrollen DataList kan innehålla kontroller som gör det möjligt för användare att ange information.

Caution

Den här kontrollen kan användas för att visa användarindata, som kan innehålla skadligt klientskript. Kontrollera all information som skickas från en klient för körbart skript, SQL-instruktioner eller annan kod innan du visar den i ditt program. Du kan använda verifieringskontroller för att verifiera användarindata innan du visar indatatexten i en kontroll. ASP.NET tillhandahåller en funktion för validering av indatabegäran för att blockera skript och HTML i användarindata.

Mer information om säkerhet finns i se Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Validating User Input in ASP.NET Web Pages.

Deklarativ syntax

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

Konstruktorer

Name	Description
DataList()	Initierar en ny instans av DataList klassen.

Fält

Name	Description
CancelCommandName	`Cancel` Representerar kommandonamnet. Detta fält är skrivskyddat.
DeleteCommandName	`Delete` Representerar kommandonamnet. Detta fält är skrivskyddat.
EditCommandName	`Edit` Representerar kommandonamnet. Detta fält är skrivskyddat.
SelectCommandName	`Select` Representerar kommandonamnet. Detta fält är skrivskyddat.
UpdateCommandName	`Update` Representerar kommandonamnet. Detta fält är skrivskyddat.

Egenskaper

Name	Description
AccessKey	Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl)
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AlternatingItemStyle	Hämtar formategenskaperna för att växla objekt i DataList kontrollen.
AlternatingItemTemplate	Hämtar eller anger mallen för alternerande objekt i DataList.
AppRelativeTemplateSourceDirectory	Hämtar eller anger den programrelativa virtuella katalogen Page UserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control)
Attributes	Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen. (Ärvd från WebControl)
BackColor	Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl)
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
BorderColor	Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl)
BorderStyle	Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl)
BorderWidth	Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl)
Caption	Hämtar eller anger texten som ska återges i ett HTML-textelement i kontrollen. Den här egenskapen tillhandahålls för att göra kontrollen mer tillgänglig för användare av hjälpmedelsteknikenheter. (Ärvd från BaseDataList)
CaptionAlign	Hämtar eller anger den vågräta eller lodräta positionen för HTML-textelementet i en kontroll. Den här egenskapen tillhandahålls för att göra kontrollen mer tillgänglig för användare av hjälpmedelsteknikenheter. (Ärvd från BaseDataList)
CellPadding	Hämtar eller anger mängden utrymme mellan innehållet i en cell och cellens kantlinje. (Ärvd från BaseDataList)
CellSpacing	Hämtar eller anger mängden utrymme mellan celler. (Ärvd från BaseDataList)
ChildControlsCreated	Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control)
ClientID	Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control)
ClientIDMode	Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control)
ClientIDSeparator	Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control)
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som innehåller en samling underordnade kontroller i en datalistningskontroll. (Ärvd från BaseDataList)
ControlStyle	Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlStyleCreated	Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
CssClass	Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl)
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeyField	Hämtar eller anger nyckelfältet i den datakälla som anges av DataSource egenskapen. (Ärvd från BaseDataList)
DataKeys	Hämtar ett DataKeyCollection objekt som lagrar nyckelvärdena för varje post i en datalistekontroll. (Ärvd från BaseDataList)
DataKeysArray	Hämtar ett ArrayList objekt som innehåller nyckelvärdena för varje post i en datalistningskontroll. (Ärvd från BaseDataList)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DataMember	Hämtar eller anger den specifika datamedlemmen i en datakälla med flera medlemmar för att binda till en kontroll för datalistning. (Ärvd från BaseDataList)
DataSource	Hämtar eller anger källan som innehåller en lista med värden som används för att fylla i objekten i kontrollen. (Ärvd från BaseDataList)
DataSourceID	Hämtar eller anger egenskapen för ID den datakällakontroll som datalistningskontrollen ska använda för att hämta datakällan. (Ärvd från BaseDataList)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
EditItemIndex	Hämtar eller anger indexnumret för det markerade objektet i kontrollen DataList som ska redigeras.
EditItemStyle	Hämtar formategenskaperna för det objekt som valts för redigering i DataList kontrollen.
EditItemTemplate	Hämtar eller anger mallen för det objekt som valts för redigering i DataList kontrollen.
Enabled	Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad. (Ärvd från WebControl)
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
ExtractTemplateRows	Hämtar eller anger ett värde som anger om raderna i en Table kontroll, som definieras i varje mall för en DataList kontroll, extraheras och visas.
Font	Hämtar teckensnittsegenskaperna som är associerade med webbserverkontrollen. (Ärvd från WebControl)
FooterStyle	Hämtar formategenskaperna för sidfotsavsnittet i DataList kontrollen.
FooterTemplate	Hämtar eller anger mallen för sidfotsavsnittet i DataList kontrollen.
ForeColor	Hämtar eller anger förgrundsfärgen (vanligtvis textens färg) för webbserverkontrollen. (Ärvd från WebControl)
GridLines	Hämtar eller anger rutnätslinjeformatet DataList för kontrollen när RepeatLayout egenskapen är inställd på `RepeatLayout.Table`.
HasAttributes	Hämtar ett värde som anger om kontrollen har attribut inställda. (Ärvd från WebControl)
HasChildViewState	Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control)
HeaderStyle	Hämtar formategenskaperna för rubrikavsnittet i DataList kontrollen.
HeaderTemplate	Hämtar eller anger mallen för rubrikavsnittet i DataList kontrollen.
Height	Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl)
HorizontalAlign	Hämtar eller anger den vågräta justeringen av en datalistningskontroll i containern. (Ärvd från BaseDataList)
ID	Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control)
IdSeparator	Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control)
Initialized	Hämtar ett värde som anger om kontrollen har initierats. (Ärvd från BaseDataList)
IsBoundUsingDataSourceID	Hämtar ett värde som anger om egenskapen DataSourceID har angetts. (Ärvd från BaseDataList)
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsEnabled	Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl)
IsTrackingViewState	Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control)
IsViewStateEnabled	Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control)
Items	Hämtar en samling DataListItem objekt som representerar de enskilda objekten i kontrollen.
ItemStyle	Hämtar formategenskaperna för objekten DataList i kontrollen.
ItemTemplate	Hämtar eller anger mallen för objekten DataList i kontrollen.
LoadViewStateByID	Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control)
NamingContainer	Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control)
Page	Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control)
Parent	Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control)
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
RepeatColumns	Hämtar eller anger antalet kolumner som ska visas i DataList kontrollen.
RepeatDirection	Hämtar eller anger om DataList kontrollen visas lodrätt eller vågrätt.
RepeatLayout	Hämtar eller anger om kontrollen visas i en tabell- eller flödeslayout.
RequiresDataBinding	Hämtar eller anger ett värde som anger om datalistningskontrollen behöver bindas till den angivna datakällan. (Ärvd från BaseDataList)
SelectArguments	Hämtar ett DataSourceSelectArguments objekt som den databundna kontrollen använder när data hämtas från en datakällakontroll. (Ärvd från BaseDataList)
SelectedIndex	Hämtar eller anger indexet för det markerade objektet i DataList kontrollen.
SelectedItem	Hämtar det markerade objektet i DataList kontrollen.
SelectedItemStyle	Hämtar formategenskaperna för det markerade objektet i DataList kontrollen.
SelectedItemTemplate	Hämtar eller anger mallen för det markerade objektet i DataList kontrollen.
SelectedValue	Hämtar värdet för nyckelfältet för det markerade datalistobjektet.
SeparatorStyle	Hämtar formategenskaperna för avgränsaren mellan varje objekt i DataList kontrollen.
SeparatorTemplate	Hämtar eller anger mallen för avgränsaren mellan objekten i DataList kontrollen.
ShowFooter	Hämtar eller anger ett värde som anger om sidfotsavsnittet visas i DataList kontrollen.
ShowHeader	Hämtar eller anger ett värde som anger om rubrikavsnittet visas i DataList kontrollen.
Site	Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control)
SkinID	Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl)
Style	Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl)
SupportsDisabledAttribute	Hämtar ett värde som anger om kontrollen ska ange `disabled` attributet för det renderade HTML-elementet till "inaktiverat" när kontrollens IsEnabled egenskap är `false`. (Ärvd från BaseDataList)
TabIndex	Hämtar eller anger flikindexet för webbserverkontrollen. (Ärvd från WebControl)
TagKey	Hämtar HTML-taggen som används för att återge DataList kontrollen.
TagKey	Hämtar värdet HtmlTextWriterTag som motsvarar den här webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TagName	Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TemplateControl	Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control)
TemplateSourceDirectory	Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control)
ToolTip	Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
UseAccessibleHeader	Hämtar eller anger ett värde som anger om datalistningskontrollen återger huvudet i ett tillgängligt format. Den här egenskapen tillhandahålls för att göra kontrollen mer tillgänglig för användare av hjälpmedelsteknikenheter. (Ärvd från BaseDataList)
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control)
Width	Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl)

Metoder

Name	Description
AddAttributesToRender(HtmlTextWriter)	Lägger till HTML-attribut och formatmallar som måste återges till den angivna HtmlTextWriterTag. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control objektets samling. (Ärvd från Control)
AddParsedSubObject(Object)	Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection samling. (Ärvd från BaseDataList)
ApplyStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen och skriver över alla befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ApplyStyleSheetSkin(Page)	Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control)
BeginRenderTracing(TextWriter, Object)	Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control)
BuildProfileTree(String, Boolean)	Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control)
ClearCachedClientID()	Anger det cachelagrade ClientID värdet till `null`. (Ärvd från Control)
ClearChildControlState()	Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildState()	Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildViewState()	Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearEffectiveClientIDMode()	Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control)
CopyBaseAttributes(WebControl)	Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
CreateChildControls()	Skapar en underordnad kontroll med hjälp av visningstillståndet. (Ärvd från BaseDataList)
CreateControlCollection()	Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control)
CreateControlHierarchy(Boolean)	Skapar kontrollhierarkin som används för att återge datalistekontrollen, med eller utan den angivna datakällan.
CreateControlStyle()	Skapar standardformatobjektet som används internt av DataList kontrollen för att implementera alla formatrelaterade egenskaper.
CreateDataSourceSelectArguments()	Skapar ett standardobjekt DataSourceSelectArguments som används av den databundna kontrollen om inga argument anges. (Ärvd från BaseDataList)
CreateItem(Int32, ListItemType)	Skapar ett DataListItem objekt.
DataBind()	Binder kontrollen och alla underordnade kontroller till den angivna datakällan. (Ärvd från BaseDataList)
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureDataBound()	Verifierar att datalistningskontrollen kräver databindning och att en giltig datakällakontroll har angetts innan metoden anropas DataBind() . (Ärvd från BaseDataList)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetData()	Returnerar ett -implementerat IEnumerableobjekt som representerar datakällan. (Ärvd från BaseDataList)
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetRouteUrl(Object)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(String, Object)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetRouteUrl(String, RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetUniqueIDRelativeTo(Control)	Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control)
HasControls()	Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control)
HasEvents()	Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control)
InitializeItem(DataListItem)	Initierar ett DataListItem objekt baserat på de angivna mallarna och formatmallarna för listobjektstypen.
IsLiteralContent()	Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control)
LoadControlState(Object)	Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control)
LoadViewState(Object)	Läser in kontrollens tidigare sparade vytillstånd DataList .
MapPathSecure(String)	Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MergeStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen, men skriver inte över några befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
OnBubbleEvent(Object, EventArgs)	Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki.
OnCancelCommand(DataListCommandEventArgs)	Genererar händelsen CancelCommand . På så sätt kan du ange en anpassad hanterare för händelsen.
OnDataBinding(EventArgs)	Genererar händelsen för DataBinding en BaseDataList kontroll. (Ärvd från BaseDataList)
OnDataPropertyChanged()	Anropas när en av de grundläggande egenskaperna för datakällans identifiering ändras för att binda om den databundna kontrollen till dess data. (Ärvd från BaseDataList)
OnDataSourceViewChanged(Object, EventArgs)	Genererar händelsen DataSourceViewChanged . (Ärvd från BaseDataList)
OnDeleteCommand(DataListCommandEventArgs)	Genererar händelsen DeleteCommand . På så sätt kan du ange en anpassad hanterare för händelsen.
OnEditCommand(DataListCommandEventArgs)	Genererar händelsen EditCommand . På så sätt kan du ange en anpassad hanterare för händelsen.
OnInit(EventArgs)	Genererar Init händelsen för DataList kontrollen.
OnItemCommand(DataListCommandEventArgs)	Genererar händelsen ItemCommand . På så sätt kan du ange en anpassad hanterare för händelsen.
OnItemCreated(DataListItemEventArgs)	Genererar händelsen ItemCreated . På så sätt kan du ange en anpassad hanterare för händelsen.
OnItemDataBound(DataListItemEventArgs)	Genererar händelsen ItemDataBound . På så sätt kan du ange en anpassad hanterare för händelsen.
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från BaseDataList)
OnPreRender(EventArgs)	Genererar händelsen PreRender . (Ärvd från BaseDataList)
OnSelectedIndexChanged(EventArgs)	Genererar händelsen för SelectedIndexChanged en BaseDataList kontroll. (Ärvd från BaseDataList)
OnUnload(EventArgs)	Genererar händelsen Unload . (Ärvd från Control)
OnUpdateCommand(DataListCommandEventArgs)	Genererar händelsen UpdateCommand . På så sätt kan du ange en anpassad hanterare för händelsen.
OpenFile(String)	Hämtar en Stream som används för att läsa en fil. (Ärvd från Control)
PrepareControlHierarchy()	Förbereder kontrollhierarkin för återgivning i DataList kontrollen.
RaiseBubbleEvent(Object, EventArgs)	Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control)
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Renderar kontrollen till den angivna HTML-skrivaren. (Ärvd från BaseDataList)
RenderBeginTag(HtmlTextWriter)	Renderar HTML-öppningstaggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderChildren(HtmlTextWriter)	Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control)
RenderContents(HtmlTextWriter)	Renderar listobjekten DataList i kontrollen.
RenderControl(HtmlTextWriter, ControlAdapter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control)
RenderControl(HtmlTextWriter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control)
RenderEndTag(HtmlTextWriter)	Renderar HTML-avslutande taggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ResolveAdapter()	Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control)
ResolveClientUrl(String)	Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control)
ResolveUrl(String)	Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control)
SaveControlState()	Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SaveViewState()	Sparar ändringarna i kontrollvyns tillstånd sedan den tid då sidan publicerades tillbaka till servern.
SetDesignModeState(IDictionary)	Anger designtidsdata för en kontroll. (Ärvd från Control)
SetRenderMethodDelegate(RenderMethod)	Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control)
SetTraceData(Object, Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
SetTraceData(Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TrackViewState()	Spårar ändringar i visningstillståndet DataList i kontrollen så att de kan lagras i kontrollens ViewState egenskap.

Händelser

Name	Description
CancelCommand	Inträffar när `Cancel` knappen klickas för ett objekt i DataList kontrollen.
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
DeleteCommand	Inträffar när `Delete` knappen klickas för ett objekt i DataList kontrollen.
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
EditCommand	Inträffar när `Edit` knappen klickas för ett objekt i DataList kontrollen.
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
ItemCommand	Inträffar när någon knapp klickas i DataList kontrollen.
ItemCreated	Inträffar på servern när ett objekt i DataList kontrollen skapas.
ItemDataBound	Inträffar när ett objekt är data som är bundet DataList till kontrollen.
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
SelectedIndexChanged	Inträffar när ett annat objekt har valts i en datalistekontroll mellan inlägg på servern. (Ärvd från BaseDataList)
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)
UpdateCommand	Inträffar när `Update` knappen klickas för ett objekt i DataList kontrollen.

Explicita gränssnittsimplementeringar

Name	Description
IAttributeAccessor.GetAttribute(String)	Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl)
IAttributeAccessor.SetAttribute(String, String)	Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl)
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)
IRepeatInfoUser.GetItemStyle(ListItemType, Int32)	En beskrivning av den här medlemmen finns i GetItemStyle(ListItemType, Int32).
IRepeatInfoUser.HasFooter	En beskrivning av den här medlemmen finns i HasFooter.
IRepeatInfoUser.HasHeader	En beskrivning av den här medlemmen finns i HasHeader.
IRepeatInfoUser.HasSeparators	En beskrivning av den här medlemmen finns i HasSeparators.
IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)	En beskrivning av den här medlemmen finns i RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).
IRepeatInfoUser.RepeatedItemCount	En beskrivning av den här medlemmen finns i RepeatedItemCount.

Tilläggsmetoder

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type, Object)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.
GetDefaultValues(INamingContainer)	Hämtar insamlingen av standardvärdena för den angivna datakontrollen.
GetMetaTable(INamingContainer)	Hämtar tabellmetadata för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, Object)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable)	Anger tabellmetadata för den angivna datakontrollen.
TryGetMetaTable(INamingContainer, MetaTable)	Avgör om tabellmetadata är tillgängliga.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?