DataObjectChangeEvents.EndEventGroup (Método)
终止调用 StartEventGroup 方法启动的事件组。
Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)
Sintaxis
'Declaración
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
)
Parámetros
groupId
Tipo: Int32指定的事件组的 ID 号。
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentOutOfRangeException | groupId 参数与分配的当前数目小于或等于零或更高。 |
| ArgumentException | groupId 参数无效。 |
Comentarios
在某些情况下，更改多个事件。组合需要并且视为一个原子事务。
通常，事件侦听器响应其通知事件组通过程序集事件队列引发在内部；事件组然后，在事件组，结束后的通知，请采用可处理模式事件处理 (即所有事件应用，或者该事件都不适用)。
在通知端，事件分组通过启用层次结构事件组，每个的规范实现标识的组标识。 通告人员通过调用 StartEventGroup开始，返回组的 ID。 然后通告配置调用 RaiseObjectAdded、RaiseObjectChanged和 RaiseObjectRemoved 方法，请传入组标识。(可选，通告人可以通过再次调用 StartEventGroup 自行启动嵌入的事件组，用当前组标识。)
使用组标识，最终通告配置调用 EndEventGroup。 一次最顶端的组 (调用创建的组。参数的 StartEventGroup 零次) 在一组事件结束，为该组引发的任何事件调度到侦听器。
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.