DataObjectChangeEvents (Clase)
Proporciona un conjunto de eventos que un proveedor de DDEX puede aparecer cuando los cambios de los objetos de datos se realizan, y proporciona los medios por los que un proveedor puede conectarse a ellos.
Jerarquía de herencia
System.Object
Microsoft.VisualStudio.Data.DataObjectChangeEvents
Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)
Sintaxis
'Declaración
<GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")> _
Public MustInherit Class DataObjectChangeEvents
[GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")]
public abstract class DataObjectChangeEvents
[GuidAttribute(L"5619B0F3-93CD-4af1-8FFC-458B86B45778")]
public ref class DataObjectChangeEvents abstract
[<AbstractClass>]
[<GuidAttribute("5619B0F3-93CD-4af1-8FFC-458B86B45778")>]
type DataObjectChangeEvents = class end
public abstract class DataObjectChangeEvents
El tipo DataObjectChangeEvents expone los siguientes miembros.
Constructores
| Nombre | Descripción | |
|---|---|---|
.gif "Método protegido") |
DataObjectChangeEvents | Constructor de clase.Crea una nueva instancia de la clase DataObjectChangeEvents. |
Arriba
Métodos
| Nombre | Descripción | |
|---|---|---|
.gif "Método público") |
EndEventGroup | Finaliza un grupo de eventos que se inicia llamando al método de StartEventGroup . |
|
Equals | Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object). |
|
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). |
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
OnEventGroupEnded | Controlador para el evento de EventGroupEnded . |
|
OnEventGroupStarted | Controlador para el evento de EventGroupStarted . |
|
OnObjectAdded | Controlador para el evento de ObjectAdded . |
|
OnObjectChanged | Controlador para el evento de ObjectChanged . |
|
OnObjectRemoved | Controlador para el evento de ObjectRemoved . |
|
RaiseObjectAdded(String, array<Object[]) | Genera un evento independiente de ObjectAdded , especificando el tipo de objeto y el identificador. |
|
RaiseObjectAdded(Int32, String, array<Object[]) | Provoca el evento de ObjectAdded dentro de un grupo de eventos específicos. |
|
RaiseObjectChanged(String, array<Object[]) | Genera un evento independiente de ObjectChanged , especificando el nombre de tipo y el identificador. |
|
RaiseObjectChanged(Int32, String, array<Object[]) | Provoca el evento de ObjectChanged dentro de un grupo de eventos especificado. |
|
RaiseObjectChanged(String, array<Object[], array<Object[]) | Genera un evento independiente de ObjectChanged para un objeto cuyo identificador se modificó durante el cambio. |
|
RaiseObjectChanged(Int32, String, array<Object[], array<Object[]) | Genera un evento de ObjectChanged dentro de un grupo de eventos específicos para un objeto cuyo identificador se modificó durante el cambio. |
|
RaiseObjectRemoved(String, array<Object[]) | Genera un evento independiente de ObjectRemoved , especificando el nombre del tipo y el identificador de objeto. |
|
RaiseObjectRemoved(Int32, String, array<Object[]) | Provoca el evento de ObjectRemoved dentro de un grupo de eventos especificado. |
|
RollbackEventGroup | Finaliza un grupo de eventos quitando el evento en cola establecido de grupo. |
|
StartEventGroup | Inicia un grupo de eventos iniciados por una llamada al método de StartEventGroup . |
|
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
Arriba
Eventos
| Nombre | Descripción | |
|---|---|---|
.gif "Evento público") |
EventGroupEnded | Evento se produce cuando un grupo de eventos ha finalizado. |
|
EventGroupStarted | Evento se produce cuando un grupo de eventos ha iniciado. |
|
ObjectAdded | Evento se produce cuando se ha agregado un objeto de datos. |
|
ObjectChanged | Evento se produce cuando se ha cambiado un objeto de datos. |
|
ObjectRemoved | Evento se produce cuando se ha quitado un objeto de datos. |
Arriba
Comentarios
Además de eventos unarios, esta clase permite estructure grupos de eventos.
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 [M:Microsoft.VisualStudio.Data.DataObjectChangeEvents.RaiseObjectAdded(System.String,System.Object[]],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 para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.