Classe DataObjectChangeEvents
Fornisce un insieme di eventi che un provider di DDEX può generare quando le modifiche a oggetti dati vengono selezionati e fornisce i mezzi da cui un provider può connettersi a.
Gerarchia di ereditarietà
Object
Microsoft.VisualStudio.Data.DataObjectChangeEvents
Spazio dei nomi: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)
Sintassi
'Dichiarazione
<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
Il tipo DataObjectChangeEvents espone i seguenti membri.
Costruttori
| Nome | Descrizione | |
|---|---|---|
.gif "Metodo protetto") |
DataObjectChangeEvents | Costruttore di classe.Crea una nuova istanza della classe DataObjectChangeEvents. |
In alto
Metodi
| Nome | Descrizione | |
|---|---|---|
.gif "Metodo pubblico") |
EndEventGroup | Termina un gruppo di eventi che è stato avviato chiamando il metodo StartEventGroup. |
|
Equals | Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
|
Finalize | Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection. (Ereditato da Object) |
|
GetHashCode | Funge da funzione hash predefinita. (Ereditato da Object) |
|
GetType | Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
|
MemberwiseClone | Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
|
OnEventGroupEnded | Gestore per l'evento EventGroupEnded. |
|
OnEventGroupStarted | Gestore per l'evento EventGroupStarted. |
|
OnObjectAdded | Gestore per l'evento ObjectAdded. |
|
OnObjectChanged | Gestore per l'evento ObjectChanged. |
|
OnObjectRemoved | Gestore per l'evento ObjectRemoved. |
|
RaiseObjectAdded(String, array<Object[]) | Genera un evento autonomo ObjectAdded, specificando il tipo di oggetto e l'identificatore. |
|
RaiseObjectAdded(Int32, String, array<Object[]) | Genera l'evento ObjectAdded all'interno di un gruppo di eventi specifico. |
|
RaiseObjectChanged(String, array<Object[]) | Genera un evento autonomo ObjectChanged, specificando il nome del tipo e l'identificatore. |
|
RaiseObjectChanged(Int32, String, array<Object[]) | Genera l'evento ObjectChanged all'interno di un gruppo di eventi specificato. |
|
RaiseObjectChanged(String, array<Object[], array<Object[]) | Genera un evento autonomo ObjectChanged per un oggetto di cui l'identificatore è stato modificato durante la modifica. |
|
RaiseObjectChanged(Int32, String, array<Object[], array<Object[]) | Genera un evento ObjectChanged all'interno di un gruppo di eventi specifico per un oggetto di cui l'identificatore è stato modificato durante la modifica. |
|
RaiseObjectRemoved(String, array<Object[]) | Genera un evento autonomo ObjectRemoved, specificando il nome del tipo e l'identificatore di oggetto. |
|
RaiseObjectRemoved(Int32, String, array<Object[]) | Genera l'evento ObjectRemoved all'interno di un gruppo di eventi specificato. |
|
RollbackEventGroup | Termina un gruppo di eventi rimozione dell'evento in coda impostato dal gruppo. |
|
StartEventGroup | Inizia un gruppo di eventi avviati da una chiamata al metodo StartEventGroup. |
|
ToString | Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
In alto
Eventi
| Nome | Descrizione | |
|---|---|---|
.gif "Evento pubblico") |
EventGroupEnded | Evento generato quando un gruppo di eventi è stato completato. |
|
EventGroupStarted | Evento generato quando un gruppo di eventi è stata avviata. |
|
ObjectAdded | Evento generato da un oggetto dati è stato aggiunto. |
|
ObjectChanged | Evento generato da un oggetto dati è stato modificato. |
|
ObjectRemoved | Evento generato da un oggetto dati è stato rimosso. |
In alto
Note
Oltre agli eventi singolari, questa classe consente ai gruppi di eventi della struttura.
In alcuni casi, gli eventi di modifica devono più essere raggruppati e vengono considerati come transazione atomica.
In genere, un listener di eventi risponde alle notifiche del gruppo di eventi l'assemblaggio una coda degli eventi generati in un gruppo di eventi; quindi, solo dopo che notifica nel gruppo di eventi è terminata, gli eventi elaborati in modalità transazionale cioé tutti gli eventi vengono applicati, o nessuno degli eventi vengono applicate).
Sul lato di notifica, il raggruppamento di evento viene implementato abilitando la specifica di una gerarchia di gruppi di eventi, ognuna di esse ha identificato con un ID utente gruppo. Un notificatore avvia chiamando StartEventGroup, che restituisce un ID per il gruppo. Quindi il notificatore chiama i metodi RaiseObjectAdded,RaiseObjectChanged e RaiseObjectRemoved, passando l'identificazione gruppo utente. (Facoltativamente, un notificatore può avviare un gruppo di eventi predefinito chiamando nuovamente StartEventGroup, con l'id gruppo utente corrente.)
Infine il notificatore chiama EndEventGroup mediante l'id gruppo utente. Il gruppo in primo piano (il gruppo creato chiamando StartEventGroup con un parametro di zero) dispone di una volta terminato, tutti gli eventi generati per tale gruppo viene inviato ai listener in un singolo gruppo di eventi.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.