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