BaseDataBoundControl.OnDataPropertyChanged Methode

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Bindet das datengebundene Steuerelement nach einer Änderung der Eigenschaften zum Angeben der Basisdatenquelle erneut an die Daten.

protected:
 virtual void OnDataPropertyChanged();

protected virtual void OnDataPropertyChanged ();

abstract member OnDataPropertyChanged : unit -> unit
override this.OnDataPropertyChanged : unit -> unit

Protected Overridable Sub OnDataPropertyChanged ()

Ausnahmen

HttpException

Es wurde versucht, den Eigenschaftswert während der Datenbindungsphase des Steuerelements zu ändern.

Beispiele

Das folgende Codebeispiel zeigt eine Eigenschaft, die zu einer abgeleiteten datengebundenen Steuerelementklasse gehört. Das Beispiel veranschaulicht, wie ein datengebundenes Steuerelement die OnDataPropertyChanged -Methode aufrufen kann, wenn eine Eigenschaft, die eine Datenquelle identifiziert, nach der Initialisierung des datengebundenen Steuerelements geändert wird. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die DataBoundControl-Klasse bereitgestellt wird.

public string DataTextField {
    get {
        object o = ViewState["DataTextField"];
        return((o == null) ? string.Empty : (string)o);
    }
    set {
        ViewState["DataTextField"] = value;
        if (Initialized) {
            OnDataPropertyChanged();
        }
    }
}

Public Property DataTextField() As String
    Get
        Dim o As Object = ViewState("DataTextField")
        If o Is Nothing Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("DataTextField") = value
        If (Initialized) Then
            OnDataPropertyChanged()
        End If
    End Set
End Property

Hinweise

Die OnDataPropertyChanged -Methode wird aufgerufen, wenn sich der DataSource- - DataSourceIDoder DataMember -Eigenschaftswert jederzeit ändert, nachdem das Ereignis der Seite PreRender aufgetreten ist.

Weitere Informationen

• Initialized
• DataSource
• DataSourceID