DataObjectChangeEvents.EndEventGroup 方法

停止调用 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
    类型:System.Int32
    指定的操作组的一个ID号。

异常

异常 条件
ArgumentOutOfRangeException

groupId 参数比分配的组的当前数目小于或等于零或大于。

ArgumentException

groupId 参数无效。

备注

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

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

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

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

.NET Framework 安全性

请参见

参考

DataObjectChangeEvents 类

Microsoft.VisualStudio.Data 命名空间