IComponentChangeService.OnComponentChanging(Object, MemberDescriptor) 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.
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 -> unitPublic 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.
