ITypeDescriptorContext.OnComponentChanging Method

Definition

Raises the ComponentChanging event.

C#
public bool OnComponentChanging();

Returns

true if this object can be changed; otherwise, false.

Remarks

Use the OnComponentChanging method to send notification that an instance of an object is about to be changed. This method also returns a value indicating whether this object can be changed. When false is returned, do not change the object.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnComponentChanging method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Implementers

When overriding OnComponentChanging() in a derived class, be sure to call the base class' OnComponentChanging() method so that registered delegates receive the event.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 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
.NET Standard 2.0, 2.1

See also