DataObjectChangeEvents.StartEventGroup 方法

2012-10-25

起始页启动事件的一组设置 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
父组标识符，因此，如果有的话);否则零。

返回值

类型：System.Int32
返回父组的组标识符。

异常

异常	条件
ArgumentOutOfRangeException	groupId 参数比分配的组的当前数目小于或等于零或大于。
ArgumentException	groupId 参数无效。

备注

在某些情况下，需要进行分组多个更改事件和视为一个基事务。

通常，事件侦听器响应事件组通知通过汇编事件队列将在事件组内;然后，后，事件组结束后的通知，请采用一个可处理方式处理事件(即所有事件应用，或事件都不适用）。

在通知端，事件分组通过启用层次结构事件组，每一个的规范实现标识的组标识符。通告方通过调用 StartEventGroup开始，返回组的ID。然后该通告调用 RaiseObjectAdded、RaiseObjectChanged和 RaiseObjectRemoved方法，通过该组标识符。(可选，通告方可以通过再次调用 StartEventGroup 启动嵌入事件组，与当前组标识符。）

使用该组标识符，最终该通告调用 EndEventGroup。一次最顶层的组(称为创建的组 StartEventGroup 用零的参数)在事件组中关闭，为该组引发的所有事件调度到侦听器。