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

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 der Option, das DataBinding-Ereignis auszulösen.

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. Zunächst wird die Basismethode OnDataBinding aufgerufen, und anschließend wird die ControlCollection.Clear -Methode verwendet, um alle untergeordneten Steuerelemente und die ClearChildViewState -Methode zu löschen, um alle gespeicherten Ansichtsstatuseinstellungen für diese untergeordneten Steuerelemente zu löschen. Schließlich wird die ChildControlsCreated -Eigenschaft auf true festgelegt, und das Steuerelement wird angewiesen, alle Änderungen am Ansichtszustand der neu erstellten Steuerelemente mit der TrackViewState -Methode nachzuverfolgen. Dies ist ein gängiges Verfahren 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 wurden.

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 aus, was bedeutet, dass Sie diese Methode in der Regel nicht explizit aufrufen müssen.

Diese Methode wird häufig überschrieben, wenn Sie ein benutzerdefiniertes vorlagenbasiertes datengebundenes Steuerelement erstellen. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen von vorlagenbasierten ASP.NET Benutzersteuerelementen und Entwickeln von benutzerdefinierten Data-Bound Webserversteuerelementen. Wenn diese Methode für ein Serversteuerelement aufgerufen wird, löst diese Methode alle Datenbindungsausdrücke im Serversteuerelement und in einem seiner untergeordneten Steuerelemente auf.

Weitere Informationen

• OnDataBinding(EventArgs)
• DataBinding
• DataBindChildren()
• Entwickeln von benutzerdefinierten ASP.NET Serversteuerelementen
• Übersicht über den Lebenszyklus der ASP.NET Seite

DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.

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 Ihr benutzerdefiniertes 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 mit raiseOnDataBinding festgelegt auf false , um sicherzustellen, dass die Methode der Basisklasse DataBind aufgerufen wird.

Die Control.DataBind() -Methode ruft die Control.DataBind(Boolean) -Methode auf, wobei raiseOnDataBinding auf festgelegt ist true.

Hinweis

Das Aufrufen der Control.DataBind(Boolean) -Methode mit raiseOnDataBinding set auf false bewirkt, dass alle untergeordneten Steuerelemente datengebunden an die Control.DataBind() -Methode sind.

Weitere Informationen

• DataBinding
• DataBindChildren()
• Übersicht über den Lebenszyklus der ASP.NET Seite