BaseDataBoundControl.OnDataPropertyChanged Method

Definition

Riassocia il controllo con associazione a dati ai relativi dati dopo la modifica di una delle proprietà di identificazione dell'origine dati di base.Rebinds the data-bound control to its data after one of the base data source identification properties changes.

protected:
 virtual void OnDataPropertyChanged();
protected virtual void OnDataPropertyChanged ();
abstract member OnDataPropertyChanged : unit -> unit
override this.OnDataPropertyChanged : unit -> unit
Protected Overridable Sub OnDataPropertyChanged ()

Exceptions

È stato effettuato un tentativo di modificare il valore della proprietà durante la fase di associazione dati del controllo.An attempt was made to change the property value during the data-binding phase of the control.

Examples

Nell'esempio di codice seguente viene illustrata una proprietà che appartiene a una classe di controlli con associazione a dati derivata.The following code example shows a property that belongs to a derived data-bound control class. Nell'esempio viene illustrato il modo in cui un controllo con associazione a dati può chiamare il metodo OnDataPropertyChanged se una proprietà che identifica un'origine dati viene modificata dopo l'inizializzazione del controllo con associazione a dati.The example demonstrates how a data-bound control can call the OnDataPropertyChanged method if a property that identifies a data source is changed after the data-bound control is initialized. Questo esempio di codice fa parte di un esempio più ampio fornito per la classe DataBoundControl.This code example is part of a larger example provided for the DataBoundControl class.

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

Remarks

Il metodo OnDataPropertyChanged viene chiamato quando il valore della proprietà DataSource, DataSourceIDo DataMember viene modificato in qualsiasi momento dopo l'evento PreRender della pagina.The OnDataPropertyChanged method is called when the DataSource, DataSourceID, or DataMember property value changes any time after the page's PreRender event has occurred.

Applies to

See also