HierarchicalDataBoundControl.OnDataPropertyChanged Method

Definition

Called when one of the base data source identification properties is changed, to re-bind the data-bound control to its data.

C#
protected override void OnDataPropertyChanged();

Examples

The following code 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. This code example is part of a larger example provided for the HierarchicalDataBoundControl class.

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

Remarks

The OnDataPropertyChanged method is called when the DataSource or DataSourceID is changed any time after the page's PreRender event.

Applies to

Produkt Verzie
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1