ComponentChangingEventArgs 類別

定義

public ref class ComponentChangingEventArgs sealed : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComponentChangingEventArgs : EventArgs

public sealed class ComponentChangingEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ComponentChangingEventArgs = class
    inherit EventArgs

type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

繼承

Object

EventArgs

ComponentChangingEventArgs

屬性

ComVisibleAttribute

範例

以下範例示範如何建立一個 ComponentChangingEventArgs。

public:
   // This example method creates a ComponentChangingEventArgs using the specified arguments.
   // Typically, this type of event args is created by a design mode subsystem.
   ComponentChangingEventArgs^ CreateComponentChangingEventArgs( Object^ component, MemberDescriptor^ member )
   {
      // The component that is about to change:       args.Component
      // The member that is about to change:          args.Member
      return gcnew ComponentChangingEventArgs( component,member );
   }

// This example method creates a ComponentChangingEventArgs using the specified arguments.
// Typically, this type of event args is created by a design mode subsystem.  
public ComponentChangingEventArgs CreateComponentChangingEventArgs(object component, MemberDescriptor member)
{
    ComponentChangingEventArgs args = new ComponentChangingEventArgs(component, member);

    // The component that is about to change:       args.Component
    // The member that is about to change:          args.Member

    return args;
}

' This example method creates a ComponentChangingEventArgs using the specified arguments.
' Typically, this type of event args is created by a design mode subsystem.  
Public Function CreateComponentChangingEventArgs(ByVal component As Object, ByVal member As MemberDescriptor) As ComponentChangingEventArgs
    Dim args As New ComponentChangingEventArgs(component, member)

    ' The component that is about to change:       args.Component
    ' The member that is about to change:          args.Member

    Return args
End Function

備註

ComponentChangingEventArgs 提供有關 ComponentChanging 事件的資料。 該 ComponentChanging 事件會 IComponentChangeService 通知及註冊事件處理者，目前設計文件中某個特定元件即將被更改。 此事件提供了一種廣泛可及的方法，以防止元件變更。

在更換元件之前，先 ComponentChanging 觸發事件。 此活動提供設計師中止變更的機會。 元件設計師通常會自動提升 ComponentChanging 事件。 如果某個屬性無法被更改，處理該事件的方法可以拋出例外。 例如，如果設計者檔案被檢查到原始碼控制，當使用者拒絕檢查該檔案時，處理程序通常會拋出例外。

A ComponentChangingEventArgs 提供以下資訊：

• 一個 Component 表示即將被修改的元件的屬性。

• 一個 Member 表示即將被更改成員的屬性。

給繼承者的注意事項

若該類別被指定為其他類別的基底類別，則會發生編譯器錯誤。

另請參閱

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService