Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IComponentChangeService.OnComponentChanging Method (Object, MemberDescriptor)

 

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

Namespace:   System.ComponentModel.Design
Assembly:  System (in System.dll)

void OnComponentChanging(
	object component,
	MemberDescriptor member
)

Parameters

component
Type: System.Object

The component that is about to change.

member
Type: System.ComponentModel.MemberDescriptor

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

This method raises the ComponentChanging event.

Most designers included with the Windows Software Development Kit (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.

.NET Framework
Available since 1.1
Return to top
Show:
© 2017 Microsoft