ListControlDesigner.OnDataSourceChanged Method

Definition

Called when the data source for the associated control has changed.

Overloads

OnDataSourceChanged()

Called when the data source for the associated control has changed.

OnDataSourceChanged(Boolean)

Called when the data source for the associated control has changed.

OnDataSourceChanged()

Called when the data source for the associated control has changed.

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

Examples

The following code example overrides the OnDataSourceChanged method in a class that inherits from the ListControlDesigner class. When the data source that is associated with the designer class changes, the OnDataSourceChanged method is called and this code sets a variable named changedDataSource to true.

This code example is part of a larger example provided for the ListControlDesigner class.

// If the data source changes, set a boolean variable.
public override void OnDataSourceChanged()
{
    changedDataSource = true;
} // OnDataSourceChanged
' If the data source changes, set a Boolean variable.
Public Overrides Sub OnDataSourceChanged()
    changedDataSource = True
End Sub

Remarks

The OnDataSourceChanged base method connects the associated control that is derived from the ListControl object to the current data source and, if that is different from the data source to which the control was connected, updates the design-time markup. The OnDataSourceChanged method updates the design-time markup after connecting to the current data source.

See also

Applies to

OnDataSourceChanged(Boolean)

Called when the data source for the associated control has changed.

protected:
 override void OnDataSourceChanged(bool forceUpdateView);
protected override void OnDataSourceChanged (bool forceUpdateView);
override this.OnDataSourceChanged : bool -> unit
Protected Overrides Sub OnDataSourceChanged (forceUpdateView As Boolean)

Parameters

forceUpdateView
Boolean

A Boolean that indicates whether the design-time markup is to be unconditionally updated. This parameter is ignored.

Examples

The following code example overrides the OnDataSourceChanged method in a class that inherits from the ListControlDesigner class. When the data source that is associated with the designer class changes, the OnDataSourceChanged is called and this code sets a variable named changedDataSource to true.

This code example is part of a larger example provided for the ListControlDesigner class.

// If the data source changes, set a boolean variable.
public override void OnDataSourceChanged()
{
    changedDataSource = true;
} // OnDataSourceChanged
' If the data source changes, set a Boolean variable.
Public Overrides Sub OnDataSourceChanged()
    changedDataSource = True
End Sub

Remarks

The OnDataSourceChanged base method connects the associated control that is derived from the ListControl class to the current data source and, if that is different from the data source to which the control was connected, updates the design-time markup. The OnDataSourceChanged method of the designer unconditionally updates the design-time markup after connecting to the current data source. The value of forceUpdateView is ignored.

Notes to Callers

Callers should use the public OnDataSourceChanged() override.

See also

Applies to