Classe DataObjectChangeEvents
Fornece um conjunto de eventos que um provedor de DDEX pode gerar 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
System.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 | |
|---|---|---|
.gif "Método protegido") |
DataObjectChangeEvents | Construtor da classe.Cria uma nova instância da classe de DataObjectChangeEvents . |
Superior
Métodos
| Nome | Descrição | |
|---|---|---|
.gif "Método público") |
EndEventGroup | Finaliza um grupo de evento que é lançado chamando o método de StartEventGroup . |
|
Equals | determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.) |
|
Finalize | Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.) |
|
GetHashCode | Serve como uma função de hash para um tipo específico. (Herdado de Object.) |
|
GetType | Obtém Type da instância atual. (Herdado de Object.) |
|
MemberwiseClone | Cria uma cópia superficial de Objectatual. (Herdado de Object.) |
|
OnEventGroupEnded | Manipulador para o evento de EventGroupEnded . |
|
OnEventGroupStarted | Manipulador para o evento de EventGroupStarted . |
|
OnObjectAdded | Manipulador para o evento de ObjectAdded . |
|
OnObjectChanged | Manipulador para o evento de ObjectChanged . |
|
OnObjectRemoved | Manipulador para o evento de ObjectRemoved . |
|
RaiseObjectAdded(String, array<Object[]) | Gera um evento de ObjectAdded autônomo, especificando o tipo de objeto e o identificador. |
|
RaiseObjectAdded(Int32, String, array<Object[]) | Gera o evento de ObjectAdded em um determinado grupo de evento. |
|
RaiseObjectChanged(String, array<Object[]) | Gera um evento de ObjectChanged autônomo, especificando o nome do tipo e o identificador. |
|
RaiseObjectChanged(Int32, String, array<Object[]) | Gera o evento de ObjectChanged dentro de um grupo especificado do evento. |
|
RaiseObjectChanged(String, array<Object[], array<Object[]) | Gera um evento independente de ObjectChanged para um objeto cujo identificador é alterado durante a alteração. |
|
RaiseObjectChanged(Int32, String, array<Object[], array<Object[]) | Gera um evento de ObjectChanged dentro de um grupo específico de um objeto cujo identificador é alterado durante a alteração. |
|
RaiseObjectRemoved(String, array<Object[]) | Gera um evento de ObjectRemoved autônomo, especificando o nome do tipo e o identificador de objeto. |
|
RaiseObjectRemoved(Int32, String, array<Object[]) | Gera o evento de ObjectRemoved dentro de um grupo especificado do evento. |
|
RollbackEventGroup | Finaliza um grupo de evento removendo o evento definido na fila de grupo. |
|
StartEventGroup | Inicia um grupo de eventos iniciados por uma chamada para o método de StartEventGroup . |
|
ToString | Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.) |
Superior
Eventos
| Nome | Descrição | |
|---|---|---|
.gif "Evento público") |
EventGroupEnded | Evento gerado quando um grupo de eventos concluir. |
|
EventGroupStarted | Evento gerado quando um grupo de evento iniciar. |
|
ObjectAdded | Evento gerado quando um objeto de dados é adicionado. |
|
ObjectChanged | Evento gerado quando um objeto de dados é modificado. |
|
ObjectRemoved | Evento gerado quando um objeto de dados é 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 atomic
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, os eventos são processados em uma maneira transacional (isto é, todos os eventos se aplicam, ou nenhum dos eventos se aplicam).
Em o lado de notificação, o agrupamento de evento é implementado ativando a especificação de uma hierarquia de grupos de evento, cada um de eles identificar com uma identificação de grupoUm notificador começa chamando StartEventGroup, que retorna uma identificação para o grupo.Em o notificador chama [M:Microsoft.VisualStudio.Data.DataObjectChangeEvents.RaiseObjectAdded(System.String,System.Object[]],RaiseObjectChanged, os métodos e 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 ID do grupoUma vez que o grupo top-most grupo (chamando StartEventGroup criado 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.