Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DetailsView-Klasse

.NET Framework 4

Andere Versionen

Zeigt die Werte eines einzelnen Datensatzes aus einer Datenquelle in einer Tabelle an. Dabei stellt jede Datenzeile ein Feld des Datensatzes dar. Mit dem DetailsView-Steuerelement können Sie Datensätze bearbeiten, löschen und einfügen.

Vererbungshierarchie

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.CompositeDataBoundControl
            System.Web.UI.WebControls.DetailsView

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

Syntax

C++

[ControlValuePropertyAttribute("SelectedValue")]
public class DetailsView : CompositeDataBoundControl, 
	IDataItemContainer, INamingContainer, ICallbackContainer, ICallbackEventHandler, IPostBackEventHandler, 
	IPostBackContainer, IDataBoundItemControl, IDataBoundControl, IFieldControl

ASP.NET

<asp:DetailsView />

Der DetailsView-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DetailsView	Initialisiert eine neue Instanz der DetailsView-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	AccessKey	Ruft die Zugriffstaste ab, mit der Sie schnell zum Webserversteuerelement navigieren können, oder legt diese fest. (Von WebControl geerbt.)
	Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
	AllowPaging	Ruft einen Wert ab, der angibt, ob das Pagingfeature aktiviert ist, oder legt diesen fest.
	AlternatingRowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der abwechselnden Datenzeilen in einem DetailsView-Steuerelement festlegen können.
	AppRelativeTemplateSourceDirectory	Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Von Control geerbt.)
	Attributes	Ruft die Auflistung von beliebigen Attributen (nur für die Darstellung) ab, die keinen Eigenschaften des Steuerelements entsprechen. (Von WebControl geerbt.)
	AutoGenerateDeleteButton	Ruft einen Wert ab, der angibt, ob das integrierte Steuerelement zum Löschen des aktuellen Datensatzes in einem DetailsView-Steuerelement angezeigt wird, oder legt diesen Wert fest.
	AutoGenerateEditButton	Ruft einen Wert ab, der angibt, ob die integrierten Steuerelemente zum Bearbeiten des aktuellen Datensatzes in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.
	AutoGenerateInsertButton	Ruft einen Wert ab, der angibt, ob die integrierten Steuerelemente zum Einfügen eines neuen Datensatzes in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.
	AutoGenerateRows	Ruft einen Wert ab, der angibt, ob Zeilenfelder für jedes Feld in der Datenquelle automatisch generiert und in einem DetailsView-Steuerelement angezeigt werden, oder legt diesen Wert fest.
	BackColor	Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
	BackImageUrl	Ruft die URL eines Bildes ab, das im Hintergrund eines DetailsView-Steuerelements angezeigt werden soll, oder legt diesen fest.
	BindingContainer	Infrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
	BorderColor	Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
	BorderStyle	Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
	BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
	BottomPagerRow	Ruft ein DetailsViewRow-Objekt ab, das die unten angezeigte Pagerzeile in einem DetailsView-Steuerelement darstellt.
	Caption	Ruft den Text ab, der in einem HTML-Beschriftungselement eines DetailsView-Steuerelements gerendert werden soll, oder legt diesen Text fest. Diese Eigenschaft wird bereitgestellt, um die Barrierefreiheit des Steuerelements für Benutzer von Hilfsgeräten zu verbessern.
	CaptionAlign	Ruft die horizontale oder vertikale Position des HTML-Beschriftungselements in einem DetailsView-Steuerelement ab oder legt sie fest. Diese Eigenschaft wird bereitgestellt, um Benutzern von Hilfsgeräten die Verwendung des Steuerelements zu erleichtern.
	CellPadding	Ruft den Abstand zwischen dem Inhalt einer Zelle und ihrem Rahmen ab oder legt diesen fest.
	CellSpacing	Ruft den Abstand zwischen den Zellen ab oder legt diesen fest.
	ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
	ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Von Control geerbt.)
	ClientIDMode	Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Von Control geerbt.)
	ClientIDSeparator	Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Von Control geerbt.)
	CommandRowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung einer Befehlszeile in einem DetailsView-Steuerelement festlegen können.
	Context	Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Von Control geerbt.)
	Controls	Ruft eine Auflistung der untergeordneten Steuerelemente im zusammengesetzten datengebundenen Steuerelement ab. (Von CompositeDataBoundControl geerbt.)
	ControlStyle	Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	ControlStyleCreated	Ruft einen Wert ab, der angibt, ob ein Style-Objekt für die ControlStyle-Eigenschaft erstellt wurde. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	CssClass	Ruft die vom Webserversteuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Von WebControl geerbt.)
	CurrentMode	Ruft den aktuellen Dateneingabemodus des DetailsView-Steuerelements ab.
	DataItem	Ruft das an das DetailsView-Steuerelement gebundene Datenelement ab.
	DataItemContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Von Control geerbt.)
	DataItemCount	Ruft die Anzahl der Elemente in der zugrunde liegenden Datenquelle ab.
	DataItemIndex	Ruft den Index des Elements, das in einem DetailsView-Steuerelement angezeigt wird, aus der zugrunde liegenden Datenquelle ab.
	DataKey	Ruft ein DataKey-Objekt ab, das den Primärschlüssel des angezeigten Datensatzes darstellt.
	DataKeyNames	Ruft ein Array ab, das die Namen der Schlüsselfelder für die Datenquelle enthält.
	DataKeysContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Von Control geerbt.)
	DataMember	Ruft den Namen der Datenliste ab, an die das datengebundene Steuerelement gebunden wird, wenn die Datenquelle mehrere Listen von Datenelementen enthält, oder legt diesen fest. (Von DataBoundControl geerbt.)
	DataSource	Ruft das Objekt ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft, oder legt dieses fest. (Von BaseDataBoundControl geerbt.)
	DataSourceID	Ruft die ID des Steuerelements ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft, oder legt diese fest. (Von DataBoundControl geerbt.)
	DataSourceObject	Ruft ein Objekt ab, das die IDataSource-Schnittstelle implementiert, die Zugriff auf den Dateninhalt des Objekts bereitstellt. (Von DataBoundControl geerbt.)
	DefaultMode	Ruft den Standarddateneingabemodus des DetailsView-Steuerelements ab oder legt diesen fest.
	DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
	EditRowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Datenzeilen in einem DetailsView-Steuerelement festlegen können, wenn sich dieses im Bearbeitungsmodus befindet.
	EmptyDataRowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der leeren Datenzeile festlegen können, die angezeigt wird, wenn die an ein DetailsView-Steuerelement gebundene Datenquelle keine Datensätze enthält.
	EmptyDataTemplate	Ruft den benutzerdefinierten Inhalt für die leere Datenzeile ab, die gerendert wird, wenn ein DetailsView-Steuerelement an eine Datenquelle ohne Datensätze gebunden ist, oder legt diesen Inhalt fest.
	EmptyDataText	Ruft den Text für die leere Datenzeile ab, die gerendert wird, wenn ein DetailsView-Steuerelement an eine Datenquelle ohne Datensätze gebunden ist, oder legt den Text fest.
	Enabled	Ruft einen Wert ab, der angibt, ob das Webserversteuerelement aktiviert ist, oder legt diesen fest. (Von WebControl geerbt.)
	EnableModelValidation	Ruft einen Wert ab, der angibt, ob die Validierung im Datenmodell aktiviert ist, oder legt diesen fest.
	EnablePagingCallbacks	Ruft einen Wert ab, der angibt, ob clientseitige Rückruffunktionen für Pagingvorgänge im DetailsView-Steuerelement verwendet werden, oder legt diesen Wert fest.
	EnableTheming	Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Von WebControl geerbt.)
	EnableViewState	Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Von Control geerbt.)
	Events	Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
	FieldHeaderStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Headerspalte in einem DetailsView-Steuerelement festlegen können.
	Fields	Ruft eine Auflistung von DataControlField-Objekten ab, die die explizit deklarierten Zeilenfelder in einem DetailsView-Steuerelement darstellen.
	Font	Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Von WebControl geerbt.)
	FooterRow	Ruft ein DetailsViewRow-Objekt ab, das die Footerzeile in einem DetailsView-Steuerelement darstellt.
	FooterStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Footerzeile in einem DetailsView-Steuerelement festlegen können.
	FooterTemplate	Ruft den benutzerdefinierten Inhalt für die Footerzeile in einem DetailsView-Steuerelement ab oder legt diesen fest.
	FooterText	Ruft den Text ab, der in der Footerzeile eines DetailsView-Steuerelements angezeigt werden soll, oder legt diesen fest.
	ForeColor	Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Von WebControl geerbt.)
	GridLines	Ruft den Rasterlinienstil für ein DetailsView-Steuerelement ab oder legt diesen fest.
	HasAttributes	Ruft einen Wert ab, der angibt, ob für das Steuerelement Attribute festgelegt wurden. (Von WebControl geerbt.)
	HasChildViewState	Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Von Control geerbt.)
	HeaderRow	Ruft ein DetailsViewRow-Objekt ab, das die Headerzeile in einem DetailsView-Steuerelement darstellt.
	HeaderStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Headerzeile in einem DetailsView-Steuerelement festlegen können.
	HeaderTemplate	Ruft den benutzerdefinierten Inhalt für die Headerzeile in einem DetailsView-Steuerelement ab oder legt diesen fest.
	HeaderText	Ruft den Text ab, der in der Headerzeile eines DetailsView-Steuerelements angezeigt werden soll, oder legt diesen fest.
	Height	Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)
	HorizontalAlign	Ruft die horizontale Ausrichtung eines DetailsView-Steuerelements auf der Seite ab bzw. legt die Ausrichtung fest.
	ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Von Control geerbt.)
	IdSeparator	Infrastruktur. Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Von Control geerbt.)
	Initialized	Ruft einen Wert ab, der angibt, ob das datengebundene Steuerelement initialisiert wurde. (Von BaseDataBoundControl geerbt.)
	InsertRowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem die Darstellung der Datenzeilen in einem DetailsView-Steuerelement festgelegt werden kann, wenn sich das DetailsView-Steuerelement im Einfügemodus befindet.
	IsBoundUsingDataSourceID	Ruft einen Wert ab, der angibt, ob die DataSourceID-Eigenschaft festgelegt ist. (Von BaseDataBoundControl geerbt.)
	IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Von Control geerbt.)
	IsEnabled	Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Von WebControl geerbt.)
	IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
	IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
	LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Von Control geerbt.)
	NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert unterschieden werden kann. (Von Control geerbt.)
	Page	Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
	PageCount	Ruft die Anzahl der Datensätze in der Datenquelle ab.
	PageIndex	Ruft den Index des angezeigten Datensatzes ab oder legt diesen fest.
	PagerSettings	Ruft einen Verweis auf das PagerSettings-Objekt ab, mit dem Sie die Eigenschaften der Pagerschaltflächen in einem DetailsView-Steuerelement festlegen können.
	PagerStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Pagerzeile in einem DetailsView-Steuerelement festlegen können.
	PagerTemplate	Ruft den benutzerdefinierten Inhalt der Pagerzeile in einem DetailsView-Steuerelement ab oder legt diesen fest.
	Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
	RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Von Control geerbt.)
	RequiresDataBinding	Ruft einen Wert ab, der angibt, ob die DataBind-Methode aufgerufen werden soll, oder legt diesen fest. (Von BaseDataBoundControl geerbt.)
	Rows	Ruft eine Auflistung von DetailsViewRow-Objekten ab, die die Datenzeilen in einem DetailsView-Steuerelement darstellen.
	RowsGenerator	Ruft ein Objekt ab, das die IAutoFieldGenerator-Schnittstelle implementiert, um Zeilen in der Ansicht automatisch zu füllen, oder legt dieses fest.
	RowStyle	Ruft einen Verweis auf das TableItemStyle-Objekt ab, mit dem Sie die Darstellung der Datenzeilen in einem DetailsView-Steuerelement festlegen können.
	SelectArguments	Ruft ein DataSourceSelectArguments-Objekt ab, das vom datengebundenen Steuerelement beim Abrufen von Daten aus einem Datenquellen-Steuerelement verwendet wird. (Von DataBoundControl geerbt.)
	SelectedValue	Ruft den Datenschlüsselwert des aktuellen Datensatzes in einem DetailsView-Steuerelement ab.
	Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Von Control geerbt.)
	SkinID	Ruft die Skin ab, die auf das Steuerelement angewendet werden soll, oder legt diese fest. (Von WebControl geerbt.)
	Style	Ruft eine Auflistung der Textattribute ab, die im äußeren Tag des Webserversteuerelements als Formatvorlagenattribut gerendert werden. (Von WebControl geerbt.)
	SupportsDisabledAttribute	Ruft einen Wert ab, der angibt, ob vom Steuerelement das disabled-Attribut des gerenderten HTML-Elements auf "disabled" festgelegt werden soll, wenn die IsEnabled-Eigenschaft des Steuerelements false ist. (Von BaseDataBoundControl geerbt.)
	TabIndex	Ruft den Index der Aktivierreihenfolge des Webserversteuerelements ab oder legt diesen fest. (Von WebControl geerbt.)
	TagKey	Ruft den HtmlTextWriterTag-Wert für das DetailsView-Steuerelement ab. (Überschreibt WebControl.TagKey.)
	TagName	Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	TemplateControl	Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Von Control geerbt.)
	TemplateSourceDirectory	Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Von Control geerbt.)
	ToolTip	Ruft den Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf das Webserversteuerelement gezeigt wird, oder legt diesen fest. (Von WebControl geerbt.)
	TopPagerRow	Ruft ein DetailsViewRow-Objekt ab, das die oberste Pagerzeile in einem DetailsView-Steuerelement darstellt.
	UniqueID	Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
	ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Von Control geerbt.)
	ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Von Control geerbt.)
	ViewStateMode	Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Von Control geerbt.)
	Visible	Ruft einen Wert ab, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite dargestellt wird, oder legt diesen fest. (Von Control geerbt.)
	Width	Ruft die Breite des Webserversteuerelements ab oder legt diese fest. (Von WebControl geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddAttributesToRender	Fügt dem angegebenen HtmlTextWriterTag die darzustellenden HTML-Attribute und -Formatvorlagen hinzu. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	AddedControl	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement der Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Von Control geerbt.)
	AddParsedSubObject	Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Von Control geerbt.)
	ApplyStyle	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement und überschreibt hierbei alle vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Von WebControl geerbt.)
	ApplyStyleSheetSkin	Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Von Control geerbt.)
	BuildProfileTree	Infrastruktur. Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Von Control geerbt.)
	ChangeMode	Schaltet das DetailsView-Steuerelement in den angegebenen Modus.
	ClearCachedClientID	Infrastruktur. Legt den zwischengespeicherten ClientID-Wert auf null fest. (Von Control geerbt.)
	ClearChildControlState	Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearChildState	Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearChildViewState	Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	ClearEffectiveClientIDMode	Infrastruktur. Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Von Control geerbt.)
	ConfirmInitState	Legt den initialisierten Zustand des datengebundenen Steuerelements fest. (Von BaseDataBoundControl geerbt.)
	CopyBaseAttributes	Kopiert die nicht vom Style-Objekt gekapselten Eigenschaften aus dem angegebenen Webserversteuerelement in das Webserversteuerelement, von dem aus diese Methode aufgerufen wird. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	CreateAutoGeneratedRow	Erstellt ein AutoGeneratedField-Objekt, das anhand der angegebenen Feldeigenschaften ein automatisch generiertes Zeilenfeld darstellt.
	CreateAutoGeneratedRows	Erstellt eine Gruppe automatisch generierter Zeilenfelder für das angegebene Datenelement.
	CreateChildControls()	Infrastruktur. Erstellt die Steuerelementhierarchie, die auf der Basis der im Ansichtszustand gespeicherten Werte zum Wiedergeben eines zusammengesetzten datengebundenen Steuerelements verwendet wird. (Von CompositeDataBoundControl geerbt.)
	CreateChildControls(IEnumerable, Boolean)	Erstellt die Steuerelementhierarchie, mit der das DetailsView-Steuerelement gerendert wird. (Überschreibt CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean).)
	CreateControlCollection	Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (literale und Serversteuerelemente) des Serversteuerelements aufnehmen soll. (Von Control geerbt.)
	CreateControlStyle	Erstellt ein standardmäßiges Tabellenformatobjekt für das DetailsView-Steuerelement. (Überschreibt WebControl.CreateControlStyle().)
	CreateDataSourceSelectArguments	Infrastruktur. Erstellt das DataSourceSelectArguments-Objekt, das an den Befehl Auswählen übergeben wird. (Überschreibt DataBoundControl.CreateDataSourceSelectArguments().)
	CreateFieldSet	Erstellt alle automatisch generierten und benutzerdefinierten Zeilenfelder, mit denen die Steuerelementhierarchie generiert wird.
	CreateRow	Erstellt ein DetailsViewRow-Objekt mit dem angegebenen Elementindex, Zeilentyp und Zeilenzustand.
	CreateTable	Erstellt die enthaltende Tabelle für das DetailsView-Steuerelement.
	DataBind()	Infrastruktur. Ruft die DataBind-Methode der Basisklasse auf. (Überschreibt BaseDataBoundControl.DataBind().)
	DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
	DataBindChildren	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
	DeleteItem	Löscht den aktuellen Datensatz aus der Datenquelle.
	Dispose	Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Von Control geerbt.)
	EnsureChildControls	Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Von Control geerbt.)
	EnsureDataBound	Infrastruktur. Ruft die DataBind-Methode auf, nachdem überprüft wurde, ob für das Datenauflistungssteuerelement Datenbindung erforderlich ist und ob ein gültiges Datenquellen-Steuerelement angegeben ist. (Überschreibt BaseDataBoundControl.EnsureDataBound().)
	EnsureID	Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
	Equals(Object)	Bestimmt, ob das übergegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	ExtractRowValues	Ruft die Werte der angezeigten Felder ab und speichert sie im angegebenen IOrderedDictionary-Objekt.
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	FindControl(String)	Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter. (Von Control geerbt.)
	FindControl(String, Int32)	Infrastruktur. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Von Control geerbt.)
	Focus	Legt den Eingabefokus auf ein Steuerelement fest. (Von Control geerbt.)
	GetCallbackResult	Gibt das Ergebnis eines Rückrufereignisses zurück, das ein Steuerelement als Ziel hat.
	GetCallbackScript	Infrastruktur. Gibt die mit dem angegebenen Argument erstellte Rückrufzeichenfolge zurück.
	GetData	Ruft ein DataSourceView-Objekt ab, mit dessen Hilfe das datengebundene Steuerelement Datenvorgänge ausführt. (Von DataBoundControl geerbt.)
	GetDataSource	Ruft die IDataSource-Schnittstelle ab, der das datengebundene Steuerelement zugeordnet ist (falls vorhanden). (Von DataBoundControl geerbt.)
	GetDesignModeState	Infrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
	GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
	GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
	GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetUniqueIDRelativeTo	Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
	HasControls	Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Von Control geerbt.)
	HasEvents	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Von Control geerbt.)
	InitializePager	Erstellt die Pagerzeile für das DetailsView-Steuerelement.
	InitializeRow	Initialisiert das angegebene DetailsViewRow-Objekt.
	InsertItem	Fügt den aktuellen Datensatz in der Datenquelle ein.
	IsBindableType	Bestimmt, ob der angegebene Datentyp an ein Feld im DetailsView-Steuerelement gebunden werden kann.
	IsLiteralContent	Infrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
	LoadControlState	Lädt den Zustand der Eigenschaften im DetailsView-Steuerelement, der auch dann beibehalten werden muss, wenn die EnableViewState-Eigenschaft auf false festgelegt ist. (Überschreibt Control.LoadControlState(Object).)
	LoadViewState	Lädt den zuvor gespeicherten Ansichtszustand des DetailsView-Steuerelements. (Überschreibt WebControl.LoadViewState(Object).)
	MapPathSecure	Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Von Control geerbt.)
	MarkAsDataBound	Legt den Zustand des Steuerelements im Ansichtszustand als erfolgreich an Daten gebunden fest. (Von DataBoundControl geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	MergeStyle	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	OnBubbleEvent	Bestimmt, ob das Ereignis für das Webserversteuerelement in der Serversteuerelement-Hierarchie der für die Seite verwendeten Benutzeroberfläche (UI) nach oben übergeben wird. (Überschreibt Control.OnBubbleEvent(Object, EventArgs).)
	OnDataBinding	Löst das DataBinding-Ereignis aus. (Von Control geerbt.)
	OnDataBound	Löst das DataBound-Ereignis aus. (Von BaseDataBoundControl geerbt.)
	OnDataPropertyChanged	Bindet das datengebundene Steuerelement nach einer Änderung der Eigenschaften zum Angeben der Basisdatenquelle erneut an die Daten. (Von DataBoundControl geerbt.)
	OnDataSourceViewChanged	Infrastruktur. Löst das DataSourceViewChanged-Ereignis aus. (Überschreibt DataBoundControl.OnDataSourceViewChanged(Object, EventArgs).)
	OnInit	Löst das Init-Ereignis aus. (Überschreibt BaseDataBoundControl.OnInit(EventArgs).)
	OnItemCommand	Löst das ItemCommand-Ereignis aus.
	OnItemCreated	Löst das ItemCreated-Ereignis aus.
	OnItemDeleted	Löst das ItemDeleted-Ereignis aus.
	OnItemDeleting	Löst das ItemDeleting-Ereignis aus.
	OnItemInserted	Löst das ItemInserted-Ereignis aus.
	OnItemInserting	Löst das ItemInserting-Ereignis aus.
	OnItemUpdated	Löst das ItemUpdated-Ereignis aus.
	OnItemUpdating	Löst das ItemUpdating-Ereignis aus.
	OnLoad	Behandelt das Control.Load-Ereignis. (Von DataBoundControl geerbt.)
	OnModeChanged	Löst das ModeChanged-Ereignis aus.
	OnModeChanging	Löst das ModeChanging-Ereignis aus.
	OnPageIndexChanged	Löst das PageIndexChanged-Ereignis aus.
	OnPageIndexChanging	Löst das PageIndexChanging-Ereignis aus.
	OnPagePreLoad	Legt den initialisierten Zustand des datengebundenen Steuerelements fest, bevor das Steuerelement geladen wird. (Überschreibt DataBoundControl.OnPagePreLoad(Object, EventArgs).)
	OnPreRender	Löst das PreRender-Ereignis aus. (Überschreibt BaseDataBoundControl.OnPreRender(EventArgs).)
	OnUnload	Löst das Unload-Ereignis aus. (Von Control geerbt.)
	OpenFile	Ruft einen Stream zum Lesen einer Datei ab. (Von Control geerbt.)
	PerformDataBinding	Infrastruktur. Bindet die angegebene Datenquelle an das DetailsView-Steuerelement. (Überschreibt CompositeDataBoundControl.PerformDataBinding(IEnumerable).)
	PerformSelect	Ruft die Daten aus der zugeordneten Datenquelle ab. (Von DataBoundControl geerbt.)
	PrepareControlHierarchy	Infrastruktur. Richtet die Steuerelementhierarchie für dieses DetailsView-Steuerelement ein.
	RaiseBubbleEvent	Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Von Control geerbt.)
	RaiseCallbackEvent	Erstellt die Argumente für den Rückrufhandler in der GetCallbackEventReference()-Methode.
	RaisePostBackEvent	Löst die entsprechenden Ereignisse für das DetailsView-Steuerelement aus, wenn es an den Server zurückgesendet wird.
	RemovedControl	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Von Control geerbt.)
	Render	Infrastruktur. Zeigt das DetailsView-Steuerelement auf dem Client mit dem angegebenen HtmlTextWriter-Objekt an. (Überschreibt WebControl.Render(HtmlTextWriter).)
	RenderBeginTag	Gibt das öffnende HTML-Tag des Steuerelements im angegebenen Writer wieder. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	RenderChildren	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
	RenderContents	Rendert den Inhalt des Steuerelements im angegebenen Writer. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	RenderControl(HtmlTextWriter)	Gibt den Inhalt des Serversteuerelements an ein angegebenes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Von Control geerbt.)
	RenderControl(HtmlTextWriter, ControlAdapter)	Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten ControlAdapter-Objekts an ein bereitgestelltes HtmlTextWriter-Objekt aus. (Von Control geerbt.)
	RenderEndTag	Stellt das schließende HTML-Tag des Steuerelements im angegebenen Writer dar. Diese Methode wird hauptsächlich beim Entwickeln von Steuerelementen verwendet. (Von WebControl geerbt.)
	ResolveAdapter	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Von Control geerbt.)
	ResolveClientUrl	Ruft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
	ResolveUrl	Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Von Control geerbt.)
	SaveControlState	Infrastruktur. Speichert den Zustand der Eigenschaften im DetailsView-Steuerelement, der auch dann beibehalten werden muss, wenn die Control.EnableViewState-Eigenschaft auf false festgelegt ist. (Überschreibt Control.SaveControlState().)
	SaveViewState	Infrastruktur. Speichert den aktuellen Ansichtszustand des DetailsView-Steuerelements. (Überschreibt WebControl.SaveViewState().)
	SetDesignModeState	Legt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
	SetPageIndex	Legt den Index der derzeit angezeigten Seite im DetailsView-Steuerelement fest.
	SetRenderMethodDelegate	Infrastruktur. Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Von Control geerbt.)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	TrackViewState	Infrastruktur. Markiert den Anfangspunkt, an dem begonnen werden soll, Änderungen am Ansichtszustand des DetailsView-Steuerelements nachzuverfolgen und zu speichern. (Überschreibt WebControl.TrackViewState().)
	UpdateItem	Aktualisiert den aktuellen Datensatz in der Datenquelle.
	ValidateDataSource	Überprüft, ob es sich bei dem Objekt, an das ein datengebundenes Steuerelement gebunden wird, um ein Objekt handelt, mit dem es arbeiten kann. (Von DataBoundControl geerbt.)

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	DataBinding	Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Von Control geerbt.)
	DataBound	Tritt ein, nachdem das Serversteuerelement an eine Datenquelle gebunden wurde. (Von BaseDataBoundControl geerbt.)
	Disposed	Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Von Control geerbt.)
	Init	Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
	ItemCommand	Tritt auf, wenn innerhalb eines DetailsView-Steuerelements auf eine Schaltfläche geklickt wird.
	ItemCreated	Tritt auf, wenn in einem DetailsView-Steuerelement ein Datensatz erstellt wird.
	ItemDeleted	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Löschen geklickt wird, allerdings erst nachdem der Löschvorgang ausgeführt wurde.
	ItemDeleting	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Löschen geklickt wird, allerdings bevor der Löschvorgang ausgeführt wird.
	ItemInserted	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Einfügen geklickt wird, allerdings erst nachdem der Einfügevorgang ausgeführt wurde.
	ItemInserting	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Einfügen geklickt wird, allerdings bevor der Einfügevorgang ausgeführt wird.
	ItemUpdated	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Aktualisieren geklickt wird, allerdings erst nachdem der Aktualisierungsvorgang ausgeführt wurde.
	ItemUpdating	Tritt ein, wenn in einem DetailsView-Steuerelement auf eine Schaltfläche Aktualisieren geklickt wird, allerdings bevor der Aktualisierungsvorgang ausgeführt wird.
	Load	Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
	ModeChanged	Tritt ein, wenn ein DetailsView-Steuerelement versucht, zwischen dem Bearbeitungsmodus, Einfügemodus und dem schreibgeschützten Modus zu wechseln, allerdings erst, nachdem die CurrentMode-Eigenschaft aktualisiert wurde.
	ModeChanging	Tritt ein, wenn ein DetailsView-Steuerelement versucht, zwischen dem Bearbeitungsmodus, Einfügemodus und dem schreibgeschützten Modus zu wechseln, allerdings bevor die CurrentMode-Eigenschaft aktualisiert wurde.
	PageIndexChanged	Tritt ein, wenn sich nach einem Pagingvorgang der Wert der PageIndex-Eigenschaft ändert.
	PageIndexChanging	Tritt ein, wenn sich vor einem Pagingvorgang der Wert der PageIndex-Eigenschaft ändert.
	PreRender	Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Von Control geerbt.)
	Unload	Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Von Control geerbt.)

Zum Seitenanfang

Erweiterungsmethoden

	Name	Beschreibung
	EnableDynamicData(Type)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	EnableDynamicData(Type, Object)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	EnableDynamicData(Type, IDictionary<String, Object>)	Überladen. Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement. (Durch DataControlExtensions definiert.)
	EnablePersistedSelection	Ermöglicht das Beibehalten der Auswahl in Datensteuerelementen, die Auswahl und Paginierung unterstützen. (Durch DynamicDataExtensions definiert.)
	FindDataSourceControl	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
	FindFieldTemplate	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
	FindMetaTable	Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
	GetDefaultValues	Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
	GetMetaTable	Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable)	Überladen. Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable, IDictionary<String, Object>)	Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	SetMetaTable(MetaTable, Object)	Überladen. Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest. (Durch DynamicDataExtensions definiert.)
	TryGetMetaTable	Bestimmt, ob Tabellenmetadaten verfügbar sind. (Durch DynamicDataExtensions definiert.)

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IAttributeAccessor.GetAttribute	Infrastruktur. Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Von WebControl geerbt.)
	IAttributeAccessor.SetAttribute	Legt zum angegebenen Namen und Wert ein Attribut des Websteuerelements fest. (Von WebControl geerbt.)
	ICallbackContainer.GetCallbackScript	Infrastruktur. Erstellt das Rückrufskript für das DetailsView-Steuerelement.
	ICallbackEventHandler.GetCallbackResult	Infrastruktur. Siehe unter der GetCallbackResult-Methode.
	ICallbackEventHandler.RaiseCallbackEvent	Infrastruktur. Löst mithilfe der angegebenen Argumente das Rückrufereignis aus.
	IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Members finden Sie unter der IControlBuilderAccessor.ControlBuilder-Methode. (Von Control geerbt.)
	IControlDesignerAccessor.GetDesignModeState	Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.GetDesignModeState-Methode. (Von Control geerbt.)
	IControlDesignerAccessor.SetDesignModeState	Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetDesignModeState-Methode. (Von Control geerbt.)
	IControlDesignerAccessor.SetOwnerControl	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetOwnerControl-Methode. (Von Control geerbt.)
	IControlDesignerAccessor.UserData	Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.UserData-Methode. (Von Control geerbt.)
	IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.DataBindings-Methode. (Von Control geerbt.)
	IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.HasDataBindings-Methode. (Von Control geerbt.)
	IDataBoundControl.DataKeyNames	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundControl.DataKeyNames.
	IDataBoundControl.DataMember	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundControl.DataMember.
	IDataBoundControl.DataSource	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundControl.DataSource.
	IDataBoundControl.DataSourceID	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundControl.DataSourceID.
	IDataBoundControl.DataSourceObject	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundControl.DataSourceObject.
	IDataBoundItemControl.DataKey	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundItemControl.DataKey.
	IDataBoundItemControl.Mode	Eine Beschreibung dieser Eigenschaft finden Sie unter IDataBoundItemControl.Mode.
	IDataItemContainer.DataItemIndex	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter DataItemIndex.
	IDataItemContainer.DisplayIndex	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter der DisplayIndex-Methode.
	IExpressionsAccessor.Expressions	Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.Expressions-Methode. (Von Control geerbt.)
	IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.HasExpressions-Methode. (Von Control geerbt.)
	IFieldControl.FieldsGenerator	Eine Beschreibung dieser Eigenschaft finden Sie unter IFieldControl.FieldsGenerator.
	IParserAccessor.AddParsedSubObject	Eine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)
	IPostBackContainer.GetPostBackOptions	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IPostBackContainer.GetPostBackOptions.
	IPostBackEventHandler.RaisePostBackEvent	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IPostBackEventHandler.RaisePostBackEvent.

Zum Seitenanfang

Hinweise

In diesem Thema:

Einführung
Zeilenfelder
Binden an Daten
Sicherheit
Datenoperationen
Anpassen der Benutzeroberfläche
Ereignisse
Barrierefreiheit
Deklarative Syntax

Einführung

Mit dem DetailsView-Steuerelement kann ein einzelner Datensatz aus einer Datenquelle in einer Tabelle angezeigt werden, wobei jedes Feld des Datensatzes in einer Zeile der Tabelle angezeigt wird. Es kann in Verbindung mit einem GridView-Steuerelement für Master-Detail-Szenarios verwendet werden. Das DetailsView-Steuerelement unterstützt die folgenden Funktionen:

Die Bindung an Datenquellensteuerelemente (z. B. SqlDataSource).
Integrierte Einfügefunktionen.
Integrierte Aktualisierungsfunktionen und Löschfunktionen.
Integrierte Pagingfunktionen.
Programmgesteuerter Zugriff auf das DetailsView-Objektmodell zum dynamischen Festlegen von Eigenschaften, Behandeln von Ereignissen usw.
Anpassbare Darstellung durch Designs und Stile.

Zeilenfelder

Die einzelnen Datenzeilen im DetailsView-Steuerelement werden erstellt, indem das entsprechende Feldsteuerelement deklariert wird. Das Verhalten der Zeilen im Steuerelement wird von verschiedenen Zeilenfeldtypen bestimmt. Feldsteuerelemente werden von einem DataControlField abgeleitet. In der folgenden Tabelle werden die verschiedenen verwendbaren Zeilenfeldtypen aufgelistet.

Spaltenfeldtyp	Beschreibungen
BoundField	Zeigt den Wert eines Felds in einer Datenquelle als Text an.
ButtonField	Zeigt im DetailsView-Steuerelement eine Befehlsschaltfläche an. Dadurch können Sie eine Zeile mit einem benutzerdefinierten Schaltflächensteuerelement anzeigen, z. B. mit der Schaltfläche Hinzufügen oder Entfernen.
CheckBoxField	Zeigt im DetailsView-Steuerelement ein Kontrollkästchen an. Dieser Zeilenfeldtyp wird in der Regel verwendet, um Felder mit einem booleschen Wert anzuzeigen.
CommandField	Zeigt integrierte Befehlsschaltflächen zum Ausführen von Bearbeitungs-, Einfüge- oder Löschvorgängen im DetailsView-Steuerelement an.
HyperLinkField	Zeigt den Wert eines Felds in einer Datenquelle als Link an. Dieser Zeilenfeldtyp ermöglicht Ihnen, ein zweites Feld an die URL des Links zu binden.
ImageField	Zeigt ein Bild im DetailsView-Steuerelement an.
TemplateField	Zeigt für eine Zeile im DetailsView-Steuerelement entsprechend einer angegebenen Vorlage benutzerdefinierten Inhalt an. Dieser Zeilenfeldtyp ermöglicht Ihnen, ein benutzerdefiniertes Zeilenfeld zu erstellen.

Standardmäßig ist die AutoGenerateRows-Eigenschaft auf true festgelegt. Damit wird in der Datenquelle für jedes Feld eines bindbaren Typs automatisch ein gebundenes Zeilenfeldobjekt generiert. Gültige bindbare Typen sind String, DateTime, Decimal, Guid und die Gruppe der primitiven Typen. Jedes Feld wird in einer Zeile als Text angezeigt – in der Reihenfolge, in der die Felder in der Datenquelle angezeigt werden.

Mit dem automatischen Generieren der Zeilen ist eine schnelle und einfache Möglichkeit gegeben, jedes Feld im Datensatz anzuzeigen. Um jedoch die erweiterten Möglichkeiten des DetailsView-Steuerelements zu nutzen, müssen Sie die Zeilenfelder explizit so deklarieren, dass sie das DetailsView-Steuerelement enthalten. Legen Sie zum Deklarieren der Zeilenfelder die AutoGenerateRows-Eigenschaft zunächst auf false fest. Fügen Sie dann <Fields> als Start- und Endtag zwischen dem Start- und dem Endtag des DetailsView-Steuerelements ein. Listen Sie abschließend zwischen dem öffnenden und schließenden <Fields>-Tag die einzufügenden Zeilenfelder auf. Die angegebenen Zeilenfelder werden in der Reihenfolge, in der sie aufgeführt sind, der Fields-Auflistung hinzugefügt. Mit der Fields-Auflistung können Sie die Zeilenfelder im DetailsView-Steuerelement programmgesteuert verwalten.

Hinweis
Automatisch generierte Zeilenfelder werden der Fields-Auflistung nicht hinzugefügt.

Hinweis
Explizit deklarierte Zeilenfelder können in Kombination mit automatisch generierten Zeilenfeldern angezeigt werden. Wenn Sie beide Zeilenfeldarten verwenden, werden zuerst die explizit deklarierten Zeilenfelder und anschließend die automatisch generierten Zeilenfelder gerendert.

Binden an Daten

Sie können das DetailsView-Steuerelement an ein Datenquellensteuerelement (z. B. SqlDataSource oder ObjectDataSource) oder an jede Datenquellenauflistung binden, die die System.Collections.IEnumerable-Schnittstelle implementiert, z. B. System.Data.DataView, System.Collections.ArrayList und System.Collections.Generic.List<T> oder andere Auflistungstypen. Mit einer der folgenden Methoden können Sie das DetailsView-Steuerelement an den entsprechenden Datenquellentyp binden:

Für die Bindung an ein Datenquellen-Steuerelement legen Sie die DataSourceID-Eigenschaft des DetailsView-Steuerelements auf den ID-Wert des Datenquellen-Steuerelements fest. Das DetailsView-Steuerelement wird automatisch an das angegebene Datenquellen-Steuerelement gebunden. Dies ist die bevorzugte Methode für die Bindung an Daten.
Zum Binden an eine Datenquelle, die die System.Collections.IEnumerable-Schnittstelle implementiert, legen Sie die DataSource-Eigenschaft des DetailsView-Steuerelements programmgesteuert auf die Datenquelle fest, und rufen Sie anschließend die DataBind-Methode auf.

Weitere Informationen über die Datenbindung finden Sie unter Binden an Datenbanken.

Sicherheit

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle Informationen, die von einem Client gesendet werden, nach ausführbaren Skripts, SQL-Anweisungen oder anderem Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeaufforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Weitere Informationen hierzu finden Sie unter Übersicht über Skriptangriffe. Validierungs-Serversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.

Datenoperationen

Das DetailsView-Steuerelement bietet dem Benutzer integrierte Funktionen zum Aktualisieren, Löschen, Einfügen und Durchblättern von Elementen im Steuerelement. Wenn das DetailsView-Steuerelement an ein Datenquellen-Steuerelement gebunden ist, kann das DetailsView-Steuerelement die Funktionen des Datenquellen-Steuerelements nutzen und automatische Aktualisierungs-, Lösch-, Einfüge- und Pagingfunktionen bereitstellen.

Hinweis
Das DetailsView-Steuerelement kann Aktualisierungs- Lösch-, Einfüge- sowie Pagingvorgänge für andere Datenquellentypen unterstützen. Sie müssen die Implementierung für diese Vorgänge allerdings in einem entsprechenden Ereignishandler bereitstellen. Weitere Informationen finden Sie unter ItemDeleting, ItemInserting und ItemUpdating.

Das DetailsView-Steuerelement kann automatisch ein CommandField-Zeilenfeld mit einer Schaltfläche Bearbeiten, Löschen oder Neu hinzufügen, indem die entsprechenden Eigenschaften AutoGenerateEditButton, AutoGenerateDeleteButton bzw. AutoGenerateInsertButton auf true festgelegt werden. Während durch das Klicken auf die Schaltfläche Löschen der markierte Datensatz umgehend gelöscht wird, wechselt das DetailsView-Steuerelement beim Klicken auf die Schaltfläche Bearbeiten oder die Schaltfläche Neu in den Bearbeitungsmodus bzw. in den Einfügemodus. Im Bearbeitungsmodus wird die Schaltfläche Bearbeiten durch eine Schaltfläche Aktualisieren und eine Schaltfläche Abbrechen ersetzt. Dem Datentyp des Felds werden entsprechende Eingabesteuerelemente (z. B. ein TextBox-Steuerelement oder ein CheckBox-Steuerelement) mit einem Feldwert angezeigt, der geändert werden kann. Über das Klicken auf die Schaltfläche Aktualisieren wird der Datensatz in der Datenquelle aktualisiert, während durch das Klicken auf die Schaltfläche Abbrechen alle Änderungen verworfen werden. Entsprechend wird im Einfügemodus die Schaltfläche Neu durch eine Schaltfläche Einfügen und eine Schaltfläche Abbrechen ersetzt, und es werden leere Eingabesteuerelemente angezeigt, in die Werte für den neuen Datensatz eingegeben werden können.

Hinweis
Zudem können Sie die Schaltflächen Aktualisieren, Löschen und Einfügen in den Zeilenfeldern ButtonField, CommandField und TemplateField manuell definieren. Das DetailsView-Steuerelement erkennt Schaltflächen, bei denen die CommandName-Eigenschaft auf "Bearbeiten", "Aktualisieren", "Löschen", "Neu", "Einfügen" oder "Abbrechen" festgelegt wurde. Sie müssen jedoch noch die Funktionalität angeben. Weitere Informationen finden Sie unter ItemDeleting, ItemInserting und ItemUpdating.

Hinweis

Zudem können Sie die Schaltflächen Aktualisieren, Löschen und Einfügen in den Zeilenfeldern ButtonField, CommandField und TemplateField manuell definieren. Das DetailsView-Steuerelement erkennt Schaltflächen, bei denen die CommandName-Eigenschaft auf "Bearbeiten", "Aktualisieren", "Löschen", "Neu", "Einfügen" oder "Abbrechen" festgelegt wurde. Sie müssen jedoch noch die Funktionalität angeben. Weitere Informationen finden Sie unter ItemDeleting, ItemInserting und ItemUpdating.

Das DetailsView-Steuerelement bietet ein Pagingfeature, mit dem zu anderen Datensätzen in der Datenquelle navigiert werden kann. Wenn Seitennavigationssteuerelemente aktiviert sind, werden sie in einer Pagerzeile angezeigt. Um Paging zu aktivieren, legen Sie die AllowPaging-Eigenschaft auf true fest. Die Pagerzeile kann mit der PagerStyle-Eigenschaft und der PagerSettings-Eigenschaft angepasst werden.

Anpassen der Benutzeroberfläche

Sie können die Darstellung des DetailsView-Steuerelements anpassen, indem Sie die Stileigenschaften für verschiedene Teile des Steuerelements festlegen. In der folgenden Tabelle sind die Stileigenschaften aufgeführt, die festgelegt werden können.

Style-Eigenschaft	Beschreibungen
AlternatingRowStyle	Die Stileinstellungen für die abwechselnden Datenzeilen im DetailsView-Steuerelement. Wenn diese Eigenschaft festgelegt ist, werden die Datenzeilen in Bändern entsprechend den RowStyle-Einstellungen und den AlternatingRowStyle-Einstellungen angezeigt.
CommandRowStyle	Die Stileinstellungen für die Zeile, die die integrierten Befehlsschaltflächen enthält.
EditRowStyle	Die Stileinstellungen für die Datenzeilen, wenn sich das DetailsView-Steuerelement im Bearbeitungsmodus befindet.
EmptyDataRowStyle	Die Stileinstellungen für die leere Datenzeile, die im DetailsView-Steuerelement angezeigt wird, wenn in der Datenquelle keine Datensätze enthalten sind.
FooterStyle	Die Stileinstellungen für die Footerzeile.
HeaderStyle	Die Stileinstellungen für die Headerzeile.
InsertRowStyle	Die Stileinstellungen für die Datenzeilen, wenn sich das DetailsView-Steuerelement im Einfügemodus befindet.
PagerStyle	Die Stileinstellungen für die Pagerzeile.
RowStyle	Die Stileinstellungen für die Datenzeilen im DetailsView-Steuerelement. Wenn die AlternatingRowStyle-Eigenschaft ebenfalls festgelegt ist, werden die Datenzeilen abwechselnd entsprechend den RowStyle-Einstellungen und den AlternatingRowStyle-Einstellungen angezeigt.
FieldHeaderStyle	Die Stileinstellungen für die Headerspalte.

Ereignisse

Das DetailsView-Steuerelement stellt mehrere Ereignisse bereit, die für die Programmierung verwendet werden können. Dadurch können Sie bei jedem Auftreten eines Ereignisses eine benutzerdefinierte Routine ausführen. In der folgenden Tabelle werden die vom DetailsView-Steuerelement unterstützten Ereignisse aufgelistet. Das DetailsView-Steuerelement erbt außerdem diese Ereignisse von seinen Basisklassen: DataBinding, DataBound, Disposed, Init, Load, PreRender und Render.

Event	Beschreibungen
ItemCommand	Tritt auf, wenn im DetailsView-Steuerelement auf eine Schaltfläche geklickt wird.
ItemCreated	Tritt auf, nachdem im DetailsView-Steuerelement alle DetailsViewRow-Objekte erstellt wurden. Dieses Ereignis wird häufig verwendet, um die Werte eines Datensatzes zu ändern, bevor dieser angezeigt wird.
ItemDeleted	Tritt ein, wenn auf eine Schaltfläche Löschen geklickt wird, allerdings nachdem das DetailsView-Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Löschvorgangs zu überprüfen.
ItemDeleting	Tritt ein, wenn auf eine Schaltfläche Löschen geklickt wird, allerdings bevor das DetailsView-Steuerelement den Datensatz aus der Datenquelle löscht. Dieses Ereignis wird häufig dazu verwendet, den Löschvorgang abzubrechen.
ItemInserted	Tritt ein, wenn auf eine Schaltfläche Einfügen geklickt wird, allerdings nachdem das DetailsView-Steuerelement den Datensatz einfügt. Dieses Ereignis wird häufig verwendet, um die Ergebnisse des Einfügevorgangs zu überprüfen.
ItemInserting	Tritt ein, wenn auf eine Schaltfläche Einfügen geklickt wird, allerdings bevor das DetailsView-Steuerelement den Datensatz einfügt. Dieses Ereignis wird häufig verwendet, um den Einfügevorgang abzubrechen.
ItemUpdated	Tritt ein, wenn auf eine Schaltfläche Aktualisieren geklickt wird, allerdings nachdem das DetailsView-Steuerelement die Zeile aktualisiert. Dieses Ereignis wird häufig dazu verwendet, die Ergebnisse des Aktualisierungsvorgangs zu überprüfen.
ItemUpdating	Tritt ein, wenn auf eine Schaltfläche Aktualisieren geklickt wird, allerdings bevor das DetailsView-Steuerelement den Datensatz aktualisiert. Dieses Ereignis wird häufig dazu verwendet, den Aktualisierungsvorgang abzubrechen.
ModeChanged	Tritt ein, nachdem das DetailsView-Steuerelement in einen anderen Modus gewechselt ist (in den Bearbeitungsmodus, den Einfügemodus oder den schreibgeschützten Modus). Dieses Ereignis wird oft zur Ausführung einer Aufgabe verwendet, wenn das DetailsView-Steuerelement den Modus ändert.
ModeChanging	Tritt ein, bevor das DetailsView-Steuerelement in einen anderen Modus gewechselt ist (in den Bearbeitungsmodus, den Einfügemodus oder den schreibgeschützten Modus). Dieses Ereignis wird oft dazu verwendet, eine Modusänderung abzubrechen.
PageIndexChanged	Tritt ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings nachdem das DetailsView-Steuerelement den Pagingvorgang behandelt hat. Dieses Ereignis wird in der Regel verwendet, wenn eine Aufgabe ausgeführt werden soll, nachdem zu einem anderen Datensatz im Steuerelement navigiert wurde.
PageIndexChanging	Tritt ein, wenn auf eine der Pagerschaltflächen geklickt wird, allerdings bevor das DetailsView-Steuerelement den Pagingvorgang behandelt. Dieses Ereignis wird oft verwendet, um den Pagingvorgang abzubrechen.

Barrierefreiheit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das Standards für Barrierefreiheit entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und Steuerelemente und Barrierefreiheit von ASP.NET

Deklarative Syntax

<asp:DetailsView
    AccessKey="string"
    AllowPaging="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateInsertButton="True|False"
    AutoGenerateRows="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    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"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DefaultMode="ReadOnly|Edit|Insert"
    EmptyDataText="string"
    Enabled="True|False"
    EnablePagingCallbacks="True|False"
    EnableTheming="True|False"
    EnableViewState="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"
    FooterText="string"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    HeaderText="string"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLoad="Load event handler"
    OnModeChanged="ModeChanged event handler"
    OnModeChanging="ModeChanging event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <AlternatingRowStyle />
        <CommandRowStyle />
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FieldHeaderStyle />
        <Fields>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Fields>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <InsertRowStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle        />
</asp:DetailsView>

Topic	Location
Gewusst wie: Dynamisches Erstellen von Vorlagen für ASP.NET-Webserversteuerelemente	Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Binden an Daten in einem vorlagenbasierten Steuerelement	Erstellen von ASP.NET-Webanwendungen
Exemplarische Vorgehensweise: Bearbeiten und Einfügen von Daten in Webseiten mit dem DetailsView-Webserver-Steuerelement	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: Bearbeiten und Einfügen von Daten in Webseiten mit dem DetailsView-Webserver-Steuerelement	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: Binden an Daten in einem vorlagenbasierten Steuerelement	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 Anwendungen mit Visual Web Developer

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein DetailsView-Steuerelement zusammen mit einem GridView-Steuerelement für ein einfaches Master-Detail-Szenario verwendet wird. Anschließend werden die Details eines im GridView-Steuerelement ausgewählten Elements angezeigt.


<%@ Page Language="C#" %>

<!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" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            <asp:GridView ID="GridView1" runat="server" 
              AutoGenerateColumns="False" DataSourceID="Customers"
              DataKeyNames="CustomerID">
              <Columns>
                <asp:CommandField ShowSelectButton="True" />
                <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
                <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              </Columns>
            </asp:GridView>
          </td>
          <td valign="top">
            <asp:DetailsView ID="DetailsView1" runat="server" 
              AutoGenerateRows="True" DataKeyNames="CustomerID"
              DataSourceID="Details" Height="50px" Width="301px">
            </asp:DetailsView>
          </td>
        </tr>
      </table>
      &nbsp;&nbsp;
      <asp:SqlDataSource ID="Details" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
        <SelectParameters>
          <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
            PropertyName="SelectedValue"
            Type="String" />
        </SelectParameters>
      </asp:SqlDataSource>
      <asp:SqlDataSource ID="Customers" runat="server" 
        ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
        SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
      </asp:SqlDataSource>
    </div>
  </form>
</body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe des DetailsView-Steuerelements Datensätze hinzugefügt, gelöscht und bearbeitet werden.



<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  void CustomerDetail_ItemInserted(object sender, 
    DetailsViewInsertedEventArgs e)
  {
    // Refresh the GridView control after a new record is inserted 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemInserting(object sender, 
    DetailsViewInsertEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.Values.Count; i++)
    {
      if (e.Values[i] != null)
      {
        e.Values[i] = Server.HtmlEncode(e.Values[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemUpdated(object sender, 
    DetailsViewUpdatedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }

  void CustomerDetail_ItemUpdating(object sender, 
    DetailsViewUpdateEventArgs e)
  {
    // Iterate though the values entered by the user and HTML encode 
    // the values. This helps prevent malicious values from being 
    // stored in the data source.
    for (int i = 0; i < e.NewValues.Count; i++)
    {
      if (e.NewValues[i] != null)
      {
        e.NewValues[i] = Server.HtmlEncode(e.NewValues[i].ToString());
      }
    }
  }

  void CustomerDetail_ItemDeleted(object sender, 
    DetailsViewDeletedEventArgs e)
  {
    // Refresh the GridView control after a new record is updated 
    // in the DetailsView control.
    CustomersView.DataBind();
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>
      DetailsView Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <h3>
      DetailsView Example</h3>
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the customers//s detailed     -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="CustomersView" DataSourceID="Customers" 
            AutoGenerateColumns="False"
            DataKeyNames="CustomerID" runat="server">
            <HeaderStyle BackColor="Blue" ForeColor="White" />
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" 
                HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" 
                HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="CustomerDetail" 
            DataSourceID="Details" AutoGenerateRows="false"
            AutoGenerateInsertButton="true" 
            AutoGenerateEditButton="true" 
            AutoGenerateDeleteButton="true"
            EmptyDataText="No records." 
            DataKeyNames="CustomerID" GridLines="Both" 
            OnItemInserted="CustomerDetail_ItemInserted"
            OnItemInserting="CustomerDetail_ItemInserting" 
            OnItemUpdated="CustomerDetail_ItemUpdated"
            OnItemUpdating="CustomerDetail_ItemUpdating" 
            OnItemDeleted="CustomerDetail_ItemDeleted"
            runat="server">
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <RowStyle BackColor="White" />
            <AlternatingRowStyle BackColor="LightGray" />
            <EditRowStyle BackColor="LightCyan" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="Address" HeaderText="Address" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
              <asp:BoundField DataField="Phone" HeaderText="Phone" />
              <asp:BoundField DataField="Fax" HeaderText="Fax" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                   -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] 
        FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" 
      ConnectionString=
        "<%$ ConnectionStrings:NorthwindConnectionString %>"
      runat="server" 
      SelectCommand="SELECT * FROM [Customers] 
        WHERE ([CustomerID] = @CustomerID)"
      DeleteCommand="DELETE FROM [Customers] 
        WHERE [CustomerID] = @CustomerID"
      InsertCommand="INSERT INTO [Customers] ([CustomerID], 
        [CompanyName], [ContactName], [ContactTitle], [Address], 
        [City], [Region], [PostalCode], [Country], [Phone], [Fax]) 
        VALUES (@CustomerID, @CompanyName, @ContactName, @ContactTitle, 
        @Address, @City, @Region, @PostalCode, @Country, @Phone, @Fax)"
      UpdateCommand="UPDATE [Customers] SET [CompanyName] = @CompanyName, 
        [ContactName] = @ContactName, [ContactTitle] = @ContactTitle, 
        [Address] = @Address, [City] = @City, [Region] = @Region, 
        [PostalCode] = @PostalCode, [Country] = @Country, 
        [Phone] = @Phone, [Fax] = @Fax 
        WHERE [CustomerID] = @CustomerID">
      <SelectParameters>
        <asp:ControlParameter ControlID="CustomersView" 
          Name="CustomerID" PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
      <DeleteParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
      </DeleteParameters>
      <UpdateParameters>
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
        <asp:Parameter Name="CustomerID" Type="String" />
      </UpdateParameters>
      <InsertParameters>
        <asp:Parameter Name="CustomerID" Type="String" />
        <asp:Parameter Name="CompanyName" Type="String" />
        <asp:Parameter Name="ContactName" Type="String" />
        <asp:Parameter Name="ContactTitle" Type="String" />
        <asp:Parameter Name="Address" Type="String" />
        <asp:Parameter Name="City" Type="String" />
        <asp:Parameter Name="Region" Type="String" />
        <asp:Parameter Name="PostalCode" Type="String" />
        <asp:Parameter Name="Country" Type="String" />
        <asp:Parameter Name="Phone" Type="String" />
        <asp:Parameter Name="Fax" Type="String" />
      </InsertParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie dem DetailsView-Steuerelement Zeilenfelder deklarativ hinzugefügt werden.


<%@ Page Language="C#" %>

<!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" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <table cellspacing="10">
      <tr>
        <td>
          <!-- Use a GridView control in combination with      -->
          <!-- a DetailsView control to display master-detail  -->
          <!-- information. When the user selects a store from -->
          <!-- GridView control, the store's detailed          -->
          <!-- information is displayed in the DetailsView     -->
          <!-- control.                                        -->
          <asp:GridView ID="GridView1" runat="server" 
            DataSourceID="Customers" AutoGenerateColumns="False" 
            DataKeyNames="CustomerID">
            <Columns>
              <asp:CommandField ShowSelectButton="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
            </Columns>
          </asp:GridView>
        </td>
        <td valign="top">
          <asp:DetailsView ID="DetailsView" runat="server"
            DataSourceID="Details" AutoGenerateRows="false"
            DataKeyNames="CustomerID" >
            <HeaderStyle BackColor="Navy" ForeColor="White" />
            <Fields>
              <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
                ReadOnly="True" />
              <asp:BoundField DataField="ContactName" HeaderText="ContactName" />
              <asp:BoundField DataField="ContactTitle" HeaderText="ContactTitle" />
              <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" />
              <asp:BoundField DataField="City" HeaderText="City" />
              <asp:BoundField DataField="Region" HeaderText="Region" />
              <asp:BoundField DataField="PostalCode" HeaderText="PostalCode" />
              <asp:BoundField DataField="Country" HeaderText="Country" />
            </Fields>
          </asp:DetailsView>
        </td>
      </tr>
    </table>
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Northwind sample database.                        -->
    <!-- It is strongly recommended that each data-bound     -->
    <!-- control uses a separate data source control.        -->
    <asp:SqlDataSource ID="Customers" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT [CompanyName], [ContactName], [CustomerID] FROM [Customers]">
    </asp:SqlDataSource>
    <!-- Add a filter to the data source control for the     -->
    <!-- DetailsView control to display the details of the   -->
    <!-- store selected in the GridView control.             -->
    <asp:SqlDataSource ID="Details" runat="server" 
      ConnectionString="<%$ ConnectionStrings:NorthwindConnectionString %>"
      SelectCommand="SELECT * FROM [Customers] WHERE ([CustomerID] = @CustomerID)">
      <SelectParameters>
        <asp:ControlParameter ControlID="GridView1" Name="CustomerID" 
          PropertyName="SelectedValue"
          Type="String" />
      </SelectParameters>
    </asp:SqlDataSource>
  </form>
</body>
</html>

Versionsinformationen

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

Plattformen

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

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

Threadsicherheit

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

Siehe auch

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN

Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?

Informationen zur Datensicherheit

DetailsView-Klasse

Einführung

Zeilenfelder

Binden an Daten

Sicherheit

Datenoperationen

Anpassen der Benutzeroberfläche

Ereignisse

Barrierefreiheit

Deklarative Syntax

.NET Framework

Referenz

Weitere Ressourcen

Community-Beiträge