DataObjectChangeEvents.StartEventGroup 方法
開始呼叫所初始化的事件群組至 StartEventGroup 方法。
命名空間： Microsoft.VisualStudio.Data
組件： Microsoft.VisualStudio.Data (在 Microsoft.VisualStudio.Data.dll 中)
語法
'宣告
Public MustOverride Function StartEventGroup ( _
groupId As Integer _
) As Integer
public abstract int StartEventGroup(
int groupId
)
public:
virtual int StartEventGroup(
int groupId
) abstract
abstract StartEventGroup :
groupId:int -> int
public abstract function StartEventGroup(
groupId : int
) : int
參數
- groupId
型別：System.Int32
父群組 ID，，如果有的話，則為零。
傳回值
型別：System.Int32
傳回父群組的群組 ID。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentOutOfRangeException | groupId 參數大於配置的群組的目前數目小於或等於零或大於。 |
| ArgumentException | groupId 參數是無效的。 |
備註
在某些情況中，多個變更事件需要群組在一起並處理以不可部分完成的交易。
一般而言，事件接聽程式回應事件群組告知藉由組合事件佇列是在事件群組內，然後，在此情況下，事件群組結束後的告知，請為以可異動方式處理事件 (也就是所有事件套用，或事件都不適用)。
在事件的告知，群組可以啟用階層架構事件群組，每一個的規格實作所識別的群組 ID。告知人員藉由呼叫 StartEventGroup開始，傳回群組物件的 ID。然後這個告知人員呼叫 RaiseObjectAdded、RaiseObjectChanged和 RaiseObjectRemoved方法，傳入群組 ID。(或者，通知使用者可以透過再次呼叫 StartEventGroup 開始內嵌事件分組，並將目前群組 ID)。
使用群組 ID，最後這個告知人員呼叫 EndEventGroup 。一次最上方的群組 (呼叫方法所建立的群組具有參數的 StartEventGroup 零) 在事件群組中結束，針對這個群組引發的所有事件分派給接聽程式。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。