Partilhar via


Classe DataObjectChangeEvents

Fornece um conjunto de eventos que um provedor de DDEX pode aumentar quando as alterações aos objetos de dados são feitas, e fornece os meios por que um provedor pode se conectar a eles.

Hierarquia de herança

Object
  Microsoft.VisualStudio.Data.DataObjectChangeEvents

Namespace:  Microsoft.VisualStudio.Data
Assembly:  Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)

Sintaxe

'Declaração
<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

O tipo DataObjectChangeEvents expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido DataObjectChangeEvents Construtor de classe.Cria uma nova instância da classe de DataObjectChangeEvents .

Superior

Métodos

  Nome Descrição
Método público EndEventGroup Finaliza um grupo de evento que é iniciado chamando o método StartEventGroup .
Método público Equals Determines whether the specified object is equal to the current object. (Herdado de Object.)
Método protegido Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
Método público GetHashCode Serves as the default hash function. (Herdado de Object.)
Método público GetType Gets the Type of the current instance. (Herdado de Object.)
Método protegido MemberwiseClone Creates a shallow copy of the current Object. (Herdado de Object.)
Método protegido OnEventGroupEnded Manipulador para o evento de EventGroupEnded .
Método protegido OnEventGroupStarted Manipulador para o evento de EventGroupStarted .
Método protegido OnObjectAdded Manipulador para o evento de ObjectAdded .
Método protegido OnObjectChanged Manipulador para o evento de ObjectChanged .
Método protegido OnObjectRemoved Manipulador para o evento de ObjectRemoved .
Método público RaiseObjectAdded(String, array<Object[]) Gerencie um evento de ObjectAdded autônomo, especificando o tipo de objeto e o identificador.
Método público RaiseObjectAdded(Int32, String, array<Object[]) Gerencie o evento de ObjectAdded dentro de um grupo específico de evento.
Método público RaiseObjectChanged(String, array<Object[]) Gerencie um evento de ObjectChanged autônomo, especificando o nome do tipo e o identificador.
Método público RaiseObjectChanged(Int32, String, array<Object[]) Gerencie o evento de ObjectChanged dentro de um grupo especificado do evento.
Método público RaiseObjectChanged(String, array<Object[], array<Object[]) Gerencie um evento autônomo de ObjectChanged para um objeto cujo identificador é alterado durante a alteração.
Método público RaiseObjectChanged(Int32, String, array<Object[], array<Object[]) Gerencie um evento de ObjectChanged dentro de um grupo específico de um objeto cujo identificador é alterado durante a alteração.
Método público RaiseObjectRemoved(String, array<Object[]) Gerencie um evento de ObjectRemoved autônomo, especificando o nome do tipo e o identificador de objeto.
Método público RaiseObjectRemoved(Int32, String, array<Object[]) Gerencie o evento de ObjectRemoved dentro de um grupo especificado do evento.
Método público RollbackEventGroup Termina um grupo de evento removendo o evento definido na fila de grupo.
Método público StartEventGroup Inicia um grupo de eventos iniciados por uma chamada para o método de StartEventGroup .
Método público ToString Returns a string that represents the current object. (Herdado de Object.)

Superior

Eventos

  Nome Descrição
Evento público EventGroupEnded Evento gerado quando um grupo de eventos concluir.
Evento público EventGroupStarted Evento gerado quando um grupo de evento iniciar.
Evento público ObjectAdded Evento gerado quando um objeto de dados for adicionado.
Evento público ObjectChanged Evento gerado quando um objeto de dados for alterado.
Evento público ObjectRemoved Evento gerado quando um objeto de dados for removido.

Superior

Comentários

Além de eventos singular, esta classe permite que você estrutura grupos de evento.

Em algumas circunstâncias, vários eventos de alteração precisam ser agrupados juntos e são tratados como uma transação atômica.

Normalmente, um evento ouvinte está notificações de evento grupo montando uma fila de eventos disparados dentro de um grupo do evento; em seguida, somente após a notificação que o grupo de evento finalizou, é eventos processados em uma maneira transacional (isto é, todos os eventos se aplicam, ou nenhum dos eventos se aplicam).

No lado de notificação, o agrupamento de evento é implementado ativando a especificação de uma hierarquia de grupos de evento, cada um deless identificar com uma identificação de grupo Um notificador começa chamando StartEventGroup, que retorna uma identificação para o grupo. No notificador chama RaiseObjectAdded,RaiseObjectChanged, e os métodos de RaiseObjectRemoved , passando em identificação de grupo (Opcionalmente, um notificador pode iniciar um grupo inserida de evento chamando StartEventGroup novamente, com a identificação do grupo atual)

Finalmente notificador chama o EndEventGroup usando a identificação do grupo Uma vez que o grupo top-most (grupo criado chamando StartEventGroup com um parâmetro de zero) finalizou, todos os eventos gerados para esse grupo são despachados para os ouvintes em um único grupo de evento.

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.VisualStudio.Data

DataObjectChangedEventHandler

DataObjectChangedEventArgs