终止调用 StartEventGroup 方法启动的事件组。
命名空间: Microsoft.VisualStudio.Data
程序集: Microsoft.VisualStudio.Data(在 Microsoft.VisualStudio.Data.dll 中)
语法
声明
Public MustOverride Sub EndEventGroup ( _
groupId As Integer _
)
public abstract void EndEventGroup(
int groupId
)
public:
virtual void EndEventGroup(
int groupId
) abstract
abstract EndEventGroup :
groupId:int -> unit
public abstract function EndEventGroup(
groupId : int
)
参数
groupId
类型:Int32指定的事件组的 ID 号。
异常
异常 | 条件 |
---|---|
ArgumentOutOfRangeException | groupId 参数与分配的当前数目小于或等于零或更高。 |
ArgumentException | groupId 参数无效。 |
备注
在某些情况下,更改多个事件。组合需要并且视为一个原子事务。
通常,事件侦听器响应其通知事件组通过程序集事件队列引发在内部;事件组然后,在事件组,结束后的通知,请采用可处理模式事件处理 (即所有事件应用,或者该事件都不适用)。
在通知端,事件分组通过启用层次结构事件组,每个的规范实现标识的组标识。 通告人员通过调用 StartEventGroup开始,返回组的 ID。 然后通告配置调用 RaiseObjectAdded、RaiseObjectChanged和 RaiseObjectRemoved 方法,请传入组标识。(可选,通告人可以通过再次调用 StartEventGroup 自行启动嵌入的事件组,用当前组标识。)
使用组标识,最终通告配置调用 EndEventGroup。 一次最顶端的组 (调用创建的组。参数的 StartEventGroup 零次) 在一组事件结束,为该组引发的任何事件调度到侦听器。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。