ComponentChangingEventArgs 類別

定義

命名空間:

System.ComponentModel.Design

組件:

System.ComponentModel.TypeConverter.dll

來源:

ComponentChangingEventArgs.cs

提供 ComponentChanging 事件的資料。 此類別無法獲得繼承。

public ref class ComponentChangingEventArgs sealed : EventArgs

public sealed class ComponentChangingEventArgs : EventArgs

type ComponentChangingEventArgs = class
    inherit EventArgs

Public NotInheritable Class ComponentChangingEventArgs
Inherits EventArgs

繼承

Object

EventArgs

ComponentChangingEventArgs

範例

下列範例示範如何建立 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 事件。 如果屬性無法變更，處理事件的方法可能會擲回例外狀況。 例如，如果設計工具檔案簽入原始程式碼控制項，如果使用者拒絕簽出檔案，此事件的處理程式通常會擲回例外狀況。

ComponentChangingEventArgs提供下列資訊：

• Component屬性，表示即將修改的元件。

• Member屬性，表示即將變更的成員。

給繼承者的注意事項

如果這個類別指定為另一個類別的基類，就會發生編譯程序錯誤。

建構函式

ComponentChangingEventArgs(Object, MemberDescriptor)

初始化 ComponentChangingEventArgs 類別的新執行個體。

屬性

Component	取得正要變更的元件或是做為正要變更成員的父容器 (Container) 之元件。
Member	取得正要變更的成員。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ComponentChanging
• ComponentChanged
• ComponentChangingEventHandler
• IComponentChangeService