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
    类型:Int32

    父组标识,因此,如果任何一个;否则零。

返回值

类型:Int32
返回要的组标识。

异常

异常 条件
ArgumentOutOfRangeException

groupId 参数与分配的当前数目小于或等于零或更高。

ArgumentException

groupId 参数无效。

备注

在某些情况下,更改多个事件。组合需要并且视为一个原子事务。

通常,事件侦听器响应其通知事件组通过程序集事件队列引发在内部;事件组然后,在事件组,结束后的通知,请采用可处理模式事件处理 (即所有事件应用,或者该事件都不适用)。

在通知端,事件分组通过启用层次结构事件组,每个的规范实现标识的组标识。 通告人员通过调用 StartEventGroup开始,返回组的 ID。 然后通告配置调用 RaiseObjectAddedRaiseObjectChangedRaiseObjectRemoved方法,请传入组标识。(可选,通告人可以通过再次调用 StartEventGroup 自行启动嵌入的事件组,用当前组标识。)

使用组标识,最终通告配置调用 EndEventGroup。 一次最顶端的组 (调用创建的组。参数的 StartEventGroup 零次) 在一组事件结束,为该组引发的任何事件调度到侦听器。

.NET Framework 安全性

请参阅

参考

DataObjectChangeEvents 类

Microsoft.VisualStudio.Data 命名空间

DataObjectChangeEvents