Gewusst wie: Hinzufügen von DataList-Webserversteuerelementen zu einer ASP.NET-Webseite

Aktualisiert: November 2007

Um einer Seite ein DataList-Webserversteuerelement hinzuzufügen, sind mehrere Schritte erforderlich. Die folgende Prozedur beschreibt die Schritte, die zum Erstellen eines funktionierenden DataList-Steuerelements nötig sind.

So fügen Sie einer ASP.NET-Webseite ein DataList-Webserversteuerelement hinzu

1. Ziehen Sie in der Entwurfsansicht von der Registerkarte Daten der Toolbox ein Datenquellensteuerelement auf die Seite, z. B. ein SqlDataSource-Steuerelement oder ein ObjectDataSource-Steuerelement.

2. Definieren Sie mithilfe des Datenquellenkonfigurations-Assistenten die Verbindung und die Abfrage- bzw. Datenabrufmethode für das Datenquellensteuerelement.

   Hinweis:

   Wenn Sie das DataList-Steuerelement zur Aktualisierung von Daten verwenden möchten (indem Sie zum Beispiel Code für das UpdateCommand-Ereignis oder das DeleteCommand-Ereignis des Steuerelements schreiben), müssen Sie sicherstellen, dass das Datenquellensteuerelement für die entsprechenden Abfragen konfiguriert wurde und die Abfragen einen Primärschlüssel enthalten. Sie können im Schritt Die Select-Anweisung konfigurieren des Datenquellenkonfigurations-Assistenten auf die Schaltfläche Erweitert klicken, um die erweiterten Optionen anzuzeigen, mit denen Sie veranlassen können, dass der Assistent Aktualisierungsabfragen generiert.

3. Ziehen Sie in der Entwurfsansicht von der Registerkarte Daten der Toolbox ein DataList-Steuerelement auf die Seite.

4. Klicken Sie mit der rechten Maustaste auf das DataList-Steuerelement, und klicken Sie dann auf Smarttag anzeigen.

5. Klicken Sie in der Liste Datenquelle auswählen auf den Namen des Datenquellensteuerelements, das Sie in den Schritten 1 und 2 erstellt haben.

   Dadurch wird die DataSourceID-Eigenschaft des Steuerelements festgelegt. Wenn die Abfrage einen Primärschlüssel enthält, wird zusätzlich die DataKeyField-Eigenschaft des Steuerelements festgelegt.

6. Klicken Sie in der Entwurfsansicht mit der rechten Maustaste auf das DataList-Steuerelement, zeigen Sie auf Vorlage bearbeiten, und klicken Sie dann auf Elementvorlagen. Das Steuerelement zeigt die Vorlagen ItemTemplate, AlternatingItemTemplate, SelectedItemTemplate und EditItemTemplate im Vorlagenbearbeitungsmodus an.

   Standardmäßig enthält die ItemTemplate-Vorlage statischen Text für Beschriftungen sowie datengebundene Label-Steuerelemente zur Anzeige der Felder in der Datenquelle.

7. Fügen Sie den Vorlagen sämtlichen HTML-Text sowie weitere Webserversteuerelemente oder HTML-Serversteuerelemente hinzu, die Sie benötigen. Weitere Informationen über das Bearbeiten von Vorlagen finden Sie unter Gewusst wie: Erstellen von Vorlagen für Webserver-Steuerelemente mithilfe des Designers.

8. Nachdem Sie die Bearbeitung der Vorlagen abgeschlossen haben, klicken Sie mit der rechten Maustaste auf das DataList-Steuerelement, und klicken Sie dann auf Vorlagenbearbeitung beenden.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anzeigen und Formatieren von Daten mit dem DataList-Webserversteuerelement

Gewusst wie: Ermöglichen des Auswählens von Elementen in DataList-Webserversteuerelementen

Gewusst wie: Ermöglichen des Bearbeitens von Elementen in DataList-Webserversteuerelementen

Gewusst wie: Ermöglichen des Löschens von Elementen in DataList-Webserversteuerelementen

Konzepte

Vorlagen für ASP.NET-Webserver-Steuerelemente

Referenz

Übersicht über das DataList-Webserversteuerelement