ComponentChangingEventArgs Class

 

Provides data for the ComponentChanging event. This class cannot be inherited.

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

System.Object
  System.EventArgs
    System.ComponentModel.Design.ComponentChangingEventArgs

[<Sealed>]
[<ComVisibleAttribute(true)>]
[<HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)>]
[<PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")>]
type ComponentChangingEventArgs = 
    class
        inherit EventArgs
    end

NameDescription
System_CAPS_pubmethodComponentChangingEventArgs(Object, MemberDescriptor)

Initializes a new instance of the ComponentChangingEventArgs class.

NameDescription
System_CAPS_pubpropertyComponent

Gets the component that is about to be changed or the component that is the parent container of the member that is about to be changed.

System_CAPS_pubpropertyMember

Gets the member that is about to be changed.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

ComponentChangingEventArgs provides data about a ComponentChanging event. The ComponentChanging event notifies the IComponentChangeService and registered event handlers that a particular component in the current design document is about to be changed. This event provides a widely accessible method to prevent a component from changing.

A ComponentChanging event is raised before a component is changed. This event provides an opportunity for a designer to abort the change. Component designers typically raise the ComponentChanging event automatically. If a property cannot be changed, the method that handles the event can throw an exception. For example, if a designer file is checked into source code control, the handler of this event typically throws an exception if the user refuses to check out the file.

A ComponentChangingEventArgs provides the following information:

  • A Component property that indicates the component that is about to be modified.

  • A Member property that indicates the member that is about to be changed.

Notes to Inheritors:

A compiler error occurs if this class is specified as the base class of another class.

The following example demonstrates creating a ComponentChangingEventArgs.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: