Übersicht über das DetailsView-Webserversteuerelement

Článek
10/22/2014

Aktualisiert: November 2007

Das DetailsView-Steuerelement zeigt einen einzelnen Datensatz aus einer Datenquelle an, wobei jede Datenzeile ein Feld des Datensatzes darstellt. Es wird oft in Verbindung mit einem GridView-Steuerelement für Master-Detail-Szenarios verwendet.

Dieses Thema enthält folgende Abschnitte:

Hintergrund
Codebeispiele
Klassenreferenz

Hintergrund

Mit dem DetailsView-Steuerelement können Sie einen einzelnen Datensatz aus einer Datenquelle zur Anzeige bringen, ändern, einfügen oder löschen. In der Voreinstellung wird jedes Feld des Datensatzes vom DetailsView-Steuerelement auf einer eigenen Zeile angezeigt. Das DetailsView-Steuerelement wird normalerweise zum Aktualisieren und zum Einfügen neuer Datensätze verwendet. Es wird häufig in sogenannten Master-Detail-Szenarien verwendet, in denen der durch das Mastersteuerelement ausgewählte Datensatz den Datensatz bestimmt, der vom DetailsView-Steuerelement angezeigt wird. Das DetailsView-Steuerelement zeigt jeweils nur einen einzigen Datensatz an, auch wenn die Datenquelle mehrere Datensätze übergibt.

Das DetailsView-Steuerelement ist auf die Fähigkeiten des Datenquellensteuerelements angewiesen, um Operationen wie das Aktualisieren, das Einfügen und das Löschen von Datensätzen auszuführen. Das DetailsView-Steuerelement unterstützt nicht die Sortierung.

Das DetailsView-Steuerelement ist in der Lage, die Daten aus der angebundenen Datenquelle seitenweise auszugeben. Dies setzt voraus, dass die Daten von einem Objekt dargestellt werden, das die ICollection-Schnittstelle unterstützt, oder dass die zugrunde liegende Datenquelle über Pagingfähigkeiten verfügt. Das DetailsView-Steuerelement stellt die Benutzeroberfläche (UI) zum Navigieren zwischen Datensätzen zur Verfügung. Legen Sie die AllowPaging-Eigenschaft auf den Wert true fest, um Paging zu aktivieren.

Die Auswahl eines bestimmten Datensatzes der zugeordneten Datenquelle erfolgt durch Blättern bis zu diesem Datensatz. Der vom DetailsView-Steuerelement angezeigte Datensatz ist der aktuell ausgewählte Datensatz.

Datenbindung mit dem DetailsView-Steuerelement

Das DetailsView-Steuerelement stellt für die Datenbindung die folgenden Optionen zur Verfügung:

Datenbindung unter Verwendung der DataSourceID-Eigenschaft, mit der Sie das DetailsView-Steuerelement an ein Datenquellensteuerelement binden können. Dies ist die empfohlene Vorgehensweise, da so das DetailsView-Steuerelement die Fähigkeiten des Datenquellensteuerelements nutzen und die integrierten Funktionen für die Aktualisierung und das Paging zur Verfügung stellen kann.
Datenbindung unter Verwendung der DataSource-Eigenschaft, mit der Sie an verschiedene Objekte binden können, darunter ADO.NET-Datasets und Datenreader. Bei dieser Vorgehensweise müssen Sie selbst den Code für zusätzliche Funktionen wie die Aktualisierung und das Paging schreiben.

Beim Herstellen einer Bindung zu einer Datenquelle unter Verwendung der DataSourceID-Eigenschaft unterstützt das DetailsView-Steuerelement die bidirektionale Datenbindung. Zusätzlich zur Anzeige der Daten können Sie die automatische Unterstützung des Steuerelements für Einfüge-, Aktualisierungs- und Löschoperationen auf den angebundenen Daten aktivieren.

Verwenden von DetailsView-Steuerelementdaten

Das DetailsView-Steuerelement wird an ein Datenquellensteuerelement gebunden, das im Gegenzug eine Verbindung zu einem Datenspeicher herstellt und die ausgewählten Daten zurückgibt. Die Verbindung zwischen dem DetailsView-Steuerelement und den Daten wird einfach durch das deklarative Festlegen der DataSourceID-Eigenschaft hergestellt. Sie können die Verbindung zu einer Datenquelle auch über Ihren Code herstellen.

Legen Sie die AutoGenerateEditButton-Eigenschaft auf den Wert true fest, um die Bearbeitung zu aktivieren. Das DetailsView-Steuerelement gibt dann zu den Datenfeldern zusätzlich eine Schaltfläche Bearbeiten aus. Beim Klicken auf die Schaltfläche Bearbeiten wechselt das DetailsView-Steuerelement in den Bearbeitungsmodus. Im Bearbeitungsmodus wird der Wert der CurrentMode-Eigenschaft des DetailsView-Steuerelements von ReadOnly in Edit geändert. Zusätzlich wird zu jedem Feld des Steuerelements die entsprechende Bearbeitungsoberfläche ausgegeben, wie zum Beispiel ein Textfeld oder ein Kontrollkästchen. Durch die Verwendung von Stilen, DataControlField-Objekten und Vorlagen können Sie die Bearbeitungsoberfläche anpassen.

Hinweis:
Die Unterstützung der Bearbeitungsfunktionen durch das DetailsView-Steuerelement setzt voraus, dass die angebundene Datenquelle Aktualisierungsoperationen auf den Daten unterstützt.

Sie können das DetailsView-Steuerelement für die Anzeige der Schaltflächen Löschen und Einfügen konfigurieren, sodass Sie den betreffenden Datensatz aus der Datenquelle löschen oder einen neuen Datensatz einfügen können. Analog zur AutoGenerateEditButton-Eigenschaft gibt das DetailsView-Steuerelement die Schaltfläche Neu aus, wenn die AutoGenerateInsertButton-Eigenschaft auf den Wert true festgelegt ist. Beim Klicken auf die Schaltfläche Neu wird der Wert der CurrentMode-Eigenschaft des DetailsView-Steuerelements auf Insert festgelegt. Das DetailsView-Steuerelement gibt für jedes angebundene Feld das passende Oberflächeneingabesteuerelement aus, wenn die InsertVisible-Eigenschaft des angebundenen Felds nicht auf den Wert false festgelegt ist.

Anpassen der Benutzeroberfläche des DetailsView-Steuerelements

Das DetailsView-Steuerelement unterstützt die Fields-Auflistungseigenschaft, die DataControlField-Objekte des Typs BoundField, CommandField oder HyperLinkField enthält. Diese Auflistung funktioniert analog zu der Columns-Auflistung des GridView-Steuerelements. Der einzige Unterschied besteht darin, dass das DetailsView-Steuerelement jedes Feld nicht als Spalte, sondern als Zeile ausgibt.

Genau wie beim GridView-Steuerelement können Sie die Oberfläche des DetailsView-Steuerelements durch die Verwendung von Stileigenschaften anpassen, darunter die Eigenschaften HeaderStyle, RowStyle, AlternatingRowStyle, CommandRowStyle, FooterStyle, PagerStyle und EmptyDataRowStyle.

Mit dem DetailsView-Steuerelement können Sie weitere Anpassungen vornehmen, indem Sie Vorlagen verwenden. Diese ermöglichen Ihnen die genauere Kontrolle der Darstellung einzelner Elemente. Sie können die Eigenschaften EmptyDataTemplate, HeaderTemplate, FooterTemplate und PagerTemplate des DetailsView-Steuerelements auf eigene, benutzerdefinierte Werte festlegen. Durch das Hinzufügen eines TemplateField-Objekts zur Fields-Auflistung können Sie eine Vorlage für einzelne Felder erstellen.

Das DetailsView-Steuerelement löst verschiedene Ereignisse aus, die Sie behandeln können, um eigenen Code auszuführen. Die Ereignisse werden vor und nach Einfüge-, Aktualisierungs- und Löschoperationen des zugeordneten Datenquellensteuerelements ausgelöst. Sie können auch Handler für das ItemCreated-Ereignis und das ItemCommand-Ereignis schreiben. Weitere Informationen finden Sie unter Übersicht über das DetailsView-Webserversteuerelement.

Hinweis:
Das Ereignismodell des DetailsView-Steuerelements ist mit dem Ereignismodell des GridView-Steuerelements vergleichbar. Allerdings bietet das DetailsView-Steuerelement keine Unterstützung für Auswahlereignisse, da immer der aktuelle Datensatz ausgewählt ist.