ListControlDesigner.OnDataSourceChanged Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.