Freigeben über

Control.DataBind Methode

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

Überlädt

Name Beschreibung
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses.

DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

public:
 virtual void DataBind();
public virtual void DataBind();
abstract member DataBind : unit -> unit
override this.DataBind : unit -> unit
Public Overridable Sub DataBind ()

Beispiele

Im folgenden Beispiel wird die DataBind Methode in einem benutzerdefinierten ASP.NET-Serversteuerelement außer Kraft gesetzt. Sie ruft zunächst die Basismethode OnDataBinding auf und verwendet dann die ControlCollection.Clear Methode, um alle untergeordneten Steuerelemente und die ClearChildViewState Methode zu löschen, um alle gespeicherten Ansichtszustandseinstellungen für diese untergeordneten Steuerelemente zu löschen. Schließlich wird die ChildControlsCreated Eigenschaft festgelegt true , und das Steuerelement wird angewiesen, alle Änderungen am Ansichtszustand der neu erstellten Steuerelemente mit der TrackViewState Methode nachzuverfolgen. Dies ist eine gängige Technik beim Binden von Daten an ein Steuerelement, um sicherzustellen, dass neue Daten nicht mit Daten in Konflikt stehen, die aus einem vorherigen DataBind Methodenaufruf gespeichert sind.

public override void DataBind() 
{
   base.OnDataBinding(EventArgs.Empty);
   // Reset the control's state.
   Controls.Clear();
   // Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   if (HasChildViewState)
      ClearChildViewState();
   ChildControlsCreated = true;
   if (!IsTrackingViewState)
      TrackViewState();
}

Public Overrides Sub DataBind()
   MyBase.OnDataBinding(EventArgs.Empty)
   ' Reset the control's state.
   Controls.Clear()
   ' Check for HasChildViewState to avoid unnecessary calls to ClearChildViewState.
   If HasChildViewState Then
      ClearChildViewState()
   End If
   ChildControlsCreated = True
   If Not IsTrackingViewState Then
      TrackViewState()
   End If
End Sub

Hinweise

Verwenden Sie diese Methode, um Daten aus einer Quelle an ein Serversteuerelement zu binden. Diese Methode wird häufig nach dem Abrufen eines Datasets über eine Datenbankabfrage verwendet. Die meisten Steuerelemente führen die Datenbindung automatisch durch, was bedeutet, dass Sie diese Methode in der Regel nicht explizit aufrufen müssen.

Diese Methode wird häufig überschrieben, wenn Sie ein benutzerdefiniertes datengebundenes Steuerelement mit Vorlagen erstellen. Weitere Informationen finden Sie unter How to: Create Templated ASP.NET User Controls and Developing Custom Data-Bound Web Server Controls. Wenn sie für ein Serversteuerelement aufgerufen wird, löst diese Methode alle Datenbindungsausdrücke im Serversteuerelement und in allen untergeordneten Steuerelementen auf.

Weitere Informationen

Gilt für:

DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses.

protected:
 virtual void DataBind(bool raiseOnDataBinding);
protected virtual void DataBind(bool raiseOnDataBinding);
abstract member DataBind : bool -> unit
override this.DataBind : bool -> unit
Protected Overridable Sub DataBind (raiseOnDataBinding As Boolean)

Parameter

raiseOnDataBinding
Boolean

true wenn das DataBinding Ereignis ausgelöst wird; andernfalls false.

Hinweise

Verwenden Sie die Control.DataBind(Boolean) Methode in einem Szenario, wenn das benutzerdefinierte Steuerelement die DataBind Methode außer Kraft setzt und die IDataItemContainer Schnittstelle implementiert. In diesem Szenario ruft das benutzerdefinierte Steuerelement die Control.DataBind(Boolean) Methode auf, die raiseOnDataBinding festgelegt ist, um false sicherzustellen, dass die Methode der Basisklasse DataBind aufgerufen wird.

Die Control.DataBind() Methode ruft die Control.DataBind(Boolean) Methode auf, auf raiseOnDataBinding die truefestgelegt ist.

Hinweis

Das Aufrufen der Control.DataBind(Boolean) Methode mit raiseOnDataBinding "set" false bewirkt, dass alle untergeordneten Steuerelemente an die Control.DataBind() Methode gebunden werden.

Weitere Informationen

Gilt für: