DataObjectChangeEvents.StartEventGroup (Método)

Inicia un grupo de eventos iniciados por una llamada 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 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: System.Int32
  La identificación del grupo primario, si la hay; si no cero.

Valor devuelto

Tipo: System.Int32
Devuelve el identificador del grupo del grupo primario.

Excepciones

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 EndEventGroup mediante 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.

Vea también

Referencia

DataObjectChangeEvents Clase

Microsoft.VisualStudio.Data (Espacio de nombres)

DataObjectChangeEvents