DataObjectChangeEvents 類別

提供 DDEX 提供者可以引發的一組事件時，這個資料物件的變更時，並且提供提供者可以連接到它們。

繼承階層架構

System.Object
  Microsoft.VisualStudio.Data.DataObjectChangeEvents

命名空間：  Microsoft.VisualStudio.Data
組件：  Microsoft.VisualStudio.Data (在 Microsoft.VisualStudio.Data.dll 中)

語法

'宣告
<GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")> _
Public MustInherit Class DataObjectChangeEvents

[GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")]
public abstract class DataObjectChangeEvents

[GuidAttribute(L"5619B0F3-93CD-4af1-8FFC-458B86B45778")]
public ref class DataObjectChangeEvents abstract

[<AbstractClass>]
[<GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")>]
type DataObjectChangeEvents =  class end

public abstract class DataObjectChangeEvents

DataObjectChangeEvents 型別會公開下列成員。

建構函式

	名稱	說明
	DataObjectChangeEvents	類別建構函式。具現化 DataObjectChangeEvents 類別的新執行個體。

回頁首

方法

	名稱	說明
	EndEventGroup	結束呼叫方法 StartEventGroup 起始事件群組。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	OnEventGroupEnded	EventGroupEnded 事件的處理常式。
	OnEventGroupStarted	EventGroupStarted 事件的處理常式。
	OnObjectAdded	ObjectAdded 事件的處理常式。
	OnObjectChanged	ObjectChanged 事件的處理常式。
	OnObjectRemoved	ObjectRemoved 事件的處理常式。
	RaiseObjectAdded(String, array<Object[])	引發 ObjectAdded 獨立的事件，指定物件型別和識別項。
	RaiseObjectAdded(Int32, String, array<Object[])	在特定事件群組內 ObjectAdded 引發事件。
	RaiseObjectChanged(String, array<Object[])	獨立的 ObjectChanged 引發事件，以指定型別名稱和識別項。
	RaiseObjectChanged(Int32, String, array<Object[])	在指定的事件 ObjectChanged 群組內引發事件。
	RaiseObjectChanged(String, array<Object[], array<Object[])	會在變更時，識別項會修改物件的獨立 ObjectChanged 事件。
	RaiseObjectChanged(Int32, String, array<Object[], array<Object[])	在特定事件群組內引發事件 ObjectChanged 在變更期間，識別項會修改的物件。
	RaiseObjectRemoved(String, array<Object[])	獨立的 ObjectRemoved 引發事件，以指定型別名稱和物件識別項。
	RaiseObjectRemoved(Int32, String, array<Object[])	在指定的事件 ObjectRemoved 群組內引發事件。
	RollbackEventGroup	藉由移除佇列中的事件結束事件群組設定從群組。
	StartEventGroup	開始呼叫所初始化的事件群組至 StartEventGroup 方法。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

事件

	名稱	說明
	EventGroupEnded	表示事件群組已完成時，引發事件。
	EventGroupStarted	表示事件群組啟動時，引發事件。
	ObjectAdded	當資料物件加入時，引發事件。
	ObjectChanged	當變更時，引發的資料物件。
	ObjectRemoved	當取消時，引發的資料物件。

回頁首

備註

刪除單一事件之外，這個類別可讓您建構事件群組。

在某些情況中，多個變更事件需要群組在一起並處理以不可部分完成的交易。

一般而言，事件接聽程式回應事件群組告知藉由組合事件佇列是在事件群組內，然後，在此情況下，事件群組結束後的告知，請為以可異動方式處理事件 (也就是所有事件套用，或事件都不適用)。

在事件的告知，群組可以啟用階層架構事件群組，每一個的規格實作所識別的群組 ID。告知人員藉由呼叫 StartEventGroup開始，傳回群組物件的 ID。然後這個告知人員呼叫 [M:Microsoft.VisualStudio.Data.DataObjectChangeEvents.RaiseObjectAdded(System.String,System.Object[]]、RaiseObjectChanged和 RaiseObjectRemoved 方法，傳入群組 ID。(或者，通知使用者可以透過再次呼叫 StartEventGroup 開始內嵌事件分組，並將目前群組 ID)。

使用群組 ID，最後這個告知人員呼叫 EndEventGroup 。一次最上方的群組 (呼叫方法所建立的群組具有參數的 StartEventGroup 零) 在事件群組中結束，針對這個群組引發的所有事件分派給接聽程式。

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data 命名空間

DataObjectChangedEventHandler

DataObjectChangedEventArgs