DataObjectChangeEvents.EndEventGroup (Método)
Finaliza un grupo de eventos que se inicia llamando al método de 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: System.Int32
Un número de identificación del grupo de eventos especificado.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentOutOfRangeException | El parámetro de groupId es menor o igual que cero o es mayor que el número actual de grupos asignados. |
| ArgumentException | El parámetro groupId no es válido. |
Comentarios
En algunas circunstancias, varios eventos de cambio deben estar agrupados y se traten como una transacción atómica.
Normalmente, un agente de escucha de eventos reacciona a las notificaciones del grupo de eventos ensamblar una cola de eventos iniciados dentro de un grupo de eventos; a continuación, una vez que la notificación de que el grupo de eventos ha finalizado, son eventos procesados de una manera transaccional (es decir, todos los eventos se aplican, o ninguno de los eventos se aplican).
En el lado de notificación, lo implementa en la agrupación de eventos la especificación de una jerarquía de grupos de eventos, cada uno de ellos identificó con un identificador de grupo.Un notificador comienza llamando a StartEventGroup, que devuelve un id. del grupo.El notificador llama RaiseObjectAdded,RaiseObjectChanged, y los métodos de RaiseObjectRemoved , pasando el identificador del grupo.(Opcionalmente, un notificador puede iniciar un grupo de eventos incrustado llamando a StartEventGroup de nuevo, con el identificador del grupo actual).
Finalmente el notificador llama EndEventGroupmediante la identificación del grupo.El grupo superior (el grupo creado llamando a StartEventGroup con un parámetro de cero) ha finalizado una vez, todos los eventos provocados para ese grupo se envía a los agentes de escucha en un único grupo de eventos.
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.