DataObjectChangeEvents.StartEventGroup (Método)
启动启动调用的事件组添加到 StartEventGroup 方法。
Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)
Sintaxis
'Declaración
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
Parámetros
groupId
Tipo: Int32父组标识,因此,如果任何一个;否则零。
Valor devuelto
Tipo: Int32
返回要的组标识。
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.