Freigeben über


DataList-Klasse

Ein datengebundenes Listensteuerelement, das Elemente mithilfe von Vorlagen anzeigt.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ControlValuePropertyAttribute("SelectedValue")> _
Public Class DataList
    Inherits BaseDataList
    Implements INamingContainer, IRepeatInfoUser
'Usage
Dim instance As DataList
[ControlValuePropertyAttribute("SelectedValue")] 
public class DataList : BaseDataList, INamingContainer, IRepeatInfoUser
[ControlValuePropertyAttribute(L"SelectedValue")] 
public ref class DataList : public BaseDataList, INamingContainer, IRepeatInfoUser
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser
ControlValuePropertyAttribute("SelectedValue") 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser

Hinweise

Mit dem DataList-Steuerelement können Sie eine mithilfe von Vorlagen definierte, datengebundene Liste anzeigen. Das DataList-Steuerelement unterstützt das Auswählen und Bearbeiten.

Der Inhalt des DataList-Steuerelements kann mithilfe von Vorlagen geändert werden. In der folgenden Tabelle sind die unterstützten Vorlagen aufgelistet.

Vorlagenname

Beschreibung

AlternatingItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für abwechselnde Elemente in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

EditItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das gegenwärtig bearbeitete Element in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

FooterTemplate

Stellt (sofern definiert) den Inhalt und das Layout für den Fußzeilenbereich in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Fußzeilenbereich angezeigt.

HeaderTemplate

Stellt (sofern definiert) den Inhalt und das Layout für den Kopfzeilenbereich in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Kopfzeilenbereich angezeigt.

ItemTemplate

Diese Vorlage muss definiert sein. Sie stellt den Inhalt und das Layout für Elemente in DataList bereit.

SelectedItemTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das gegenwärtig ausgewählte Element in DataList bereit. Wenn nicht definiert, wird ItemTemplate verwendet.

SeparatorTemplate

Stellt (sofern definiert) den Inhalt und das Layout für das Trennzeichen zwischen Elementen in DataList bereit. Wenn diese Vorlage nicht definiert ist, wird kein Trennzeichen angezeigt.

Damit die Elemente im DataList-Steuerelement angezeigt werden können, muss zumindest ItemTemplate definiert sein. Mit zusätzlichen Vorlagen kann ein benutzerdefiniertes Erscheinungsbild für das DataList-Steuerelement bereitgestellt werden.

Die Darstellung des DataList-Steuerelements kann durch Festlegen der Stileigenschaften für die unterschiedlichen Teile des Steuerelements angepasst werden. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgelistet.

Stileigenschaft

Beschreibung

AlternatingItemStyle

Gibt den Stil für abwechselnde Elemente im DataList-Steuerelement an.

EditItemStyle

Gibt den Stil für das im DataList-Steuerelement bearbeitete Element an.

FooterStyle

Gibt den Stil für die Fußzeile im DataList-Steuerelement an.

HeaderStyle

Gibt den Stil für die Kopfzeile im DataList-Steuerelement an.

ItemStyle

Gibt den Stil für die Elemente im DataList-Steuerelement an.

SelectedItemStyle

Gibt den Stil für das im DataList-Steuerelement ausgewählte Element an.

SeparatorStyle

Gibt den Stil für das Trennzeichen zwischen den Elementen im DataList-Steuerelement an.

Sie können auch verschiedene Bereiche des Steuerelements anzeigen und ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, mit denen gesteuert wird, welche Bereiche angezeigt oder ausgeblendet werden.

Eigenschaft

Beschreibung

ShowFooter

Zeigt den Fußzeilenbereich des DataList-Steuerelements an oder blendet diesen aus.

ShowHeader

Zeigt den Kopfzeilenbereich des DataList-Steuerelements an oder blendet diesen aus.

Die Anzeigerichtung eines DataList-Steuerelements kann vertikal bzw. horizontal sein. Legen Sie zum Angeben der Anzeigerichtung die RepeatDirection-Eigenschaft fest.

Das Layout des DataList-Steuerelements wird durch die RepeatLayout-Eigenschaft gesteuert. Wenn diese Eigenschaft auf RepeatLayout.Table festgelegt wird, erfolgt die Anzeige von DataList im Tabellenformat, beim Festlegen auf RepeatLayout.Flow wird DataList dagegen ohne Tabellenstruktur angezeigt.

Warnung

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die u. U. bösartige Clientskripts enthalten können. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. Mithilfe von Validierungssteuerelementen können Sie Benutzereingaben überprüfen, bevor Sie den Eingabetext in einem Steuerelement anzeigen. ASP.NET stellt ein Feature zur Anforderungsvalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Weitere Informationen finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.

Thema Position
Gewusst wie: Erstellen von Vorlagen für ASP.NET-Webserversteuerelemente Erstellen von ASP.NET-Webanwendungen
Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-Webserver-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-Daten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-Webseite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des Designers Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement in Visual Studio Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen von Master-Detail-Webseiten in Visual Studio Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von Anwendungen mit Visual Web Developer
Exemplarische Vorgehensweise: Erstellen von Master-Detail-Webseiten in Visual Studio Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Dynamisches Anpassen von Elementen im DataList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deklaratives Erstellen von Vorlagen für ASP.NET-Websteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des Designers Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-Webserversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-Daten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen von DataList-Elementen zur Laufzeit Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement in Visual Studio Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Schaltflächenereignisse in datengebundenen Steuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben von Fluss- oder Tabellenformat in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList- oder Repeater-Elementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Anpassen von Elementen im DataList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deklaratives Erstellen von Vorlagen für ASP.NET-Websteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des Designers Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-Webserversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-Daten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen von DataList-Elementen zur Laufzeit Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement in Visual Studio Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Schaltflächenereignisse in datengebundenen Steuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben von Fluss- oder Tabellenformat in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList- oder Repeater-Elementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Dynamisches Anpassen von Elementen im DataList-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen von DataList-Steuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Deklaratives Erstellen von Vorlagen für ASP.NET-Websteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben des horizontalen oder vertikalen Layouts in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Hinzufügen von Steuerelementen zu einer ASP.NET-Webseite Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-Webserversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anpassen von DataList-Elementen zur Laufzeit Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf Schaltflächenereignisse in datengebundenen Steuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben von Fluss- oder Tabellenformat in DataList-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf Schaltflächenereignisse in DataList-, Repeater- oder GridView-Elementen Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Beispiel wird das Anzeigen einer Liste von Elementen aus einer Datenquelle mit einem DataList-Steuerelement veranschaulicht.

Hinweis

Im folgenden Codebeispiel wird das Einzeldatei-Codemodell verwendet. Das Beispiel funktioniert möglicherweise nicht, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei mit einer ASPX-Erweiterung kopiert werden. Weitere Informationen zum Web Forms-Codemodell finden Sie unter Codemodell für ASP.NET-Webseiten.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <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>
 
<body>
 
   <form runat=server>

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowBorder="True"
           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"
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<html>
   <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>
 
<body>
 
   <form runat=server>

      <h3>DataList Example</h3>
 
      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           ShowBorder="True"
           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"
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>
 
      </asp:DataList>
 
   </form>
 
</body>
</html>

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.BaseDataList
        System.Web.UI.WebControls.DataList

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DataList-Member
System.Web.UI.WebControls-Namespace
BaseDataList-Klasse
DataGrid-Klasse
Repeater

Weitere Ressourcen

DataList-Webserver-Steuerelement
Sichern von Standardsteuerelementen
Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen
Überprüfen der Benutzereingabe in ASP.NET-Webseiten
Codemodell für ASP.NET-Webseiten