Edit

IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) Method

  • Reference

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Announces to the component change service that a particular component is changing.

public:
 void OnComponentChanging(System::Object ^ component, System::ComponentModel::MemberDescriptor ^ member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor member);
public void OnComponentChanging (object component, System.ComponentModel.MemberDescriptor? member);
abstract member OnComponentChanging : obj * System.ComponentModel.MemberDescriptor -> unit
Public Sub OnComponentChanging (component As Object, member As MemberDescriptor)

Parameters

component
Object

The component that is about to change.

member
MemberDescriptor

The member that is changing. This is null if this change is not related to a single member.

Remarks

This method raises the ComponentChanging event.

Most designers included with the Windows SDK, as well as the Visual Studio design-time environment, typically raise this event automatically; so most of the time, you do not need to explicitly call this method. The appropriate IComponentChangeService events are automatically raised when a PropertyDescriptor is used to change a property value or components are added or removed from the IDesignerHost container.

Notes to Implementers

This method throws an exception if the property cannot be changed. This is not intended to validate the values of a particular property. Instead, it is intended to provide a global method of preventing a component from changing. For example, if a designer file is checked into source code control, this event's handler would typically throw an exception if the user refused to check out the file.

Applies to

See also