DataObjectChangeEvents, classe

Fournit un jeu d'événements qu'un fournisseur de DDEX peut déclencher lorsque les modifications apportées aux objets de données sont apportées, et offre des moyens par lesquels un fournisseur peut se connecter à eux.

Hiérarchie d'héritage

System.Object
  Microsoft.VisualStudio.Data.DataObjectChangeEvents

Espace de noms :  Microsoft.VisualStudio.Data
Assembly :  Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)

Syntaxe

'Déclaration
<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

Le type DataObjectChangeEvents expose les membres suivants.

Constructeurs

  Nom Description
Méthode protégée DataObjectChangeEvents Constructeur de classe.Instancie une nouvelle instance de la classe DataObjectChangeEvents.

Début

Méthodes

  Nom Description
Méthode publique EndEventGroup Met fin à un groupe d'événements qui a été initialisé en appelant la méthode d' StartEventGroup .
Méthode publique Equals Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégée OnEventGroupEnded Gestionnaire pour l'événement d' EventGroupEnded .
Méthode protégée OnEventGroupStarted Gestionnaire pour l'événement d' EventGroupStarted .
Méthode protégée OnObjectAdded Gestionnaire pour l'événement d' ObjectAdded .
Méthode protégée OnObjectChanged Gestionnaire pour l'événement d' ObjectChanged .
Méthode protégée OnObjectRemoved Gestionnaire pour l'événement d' ObjectRemoved .
Méthode publique RaiseObjectAdded(String, array<Object[]) Déclenche un événement autonome d' ObjectAdded , en spécifiant le type d'objet et l'identificateur.
Méthode publique RaiseObjectAdded(Int32, String, array<Object[]) Déclenche l'événement d' ObjectAdded au sein d'un groupe d'événement spécifique.
Méthode publique RaiseObjectChanged(String, array<Object[]) Déclenche un événement autonome d' ObjectChanged , en spécifiant le nom et identificateur.
Méthode publique RaiseObjectChanged(Int32, String, array<Object[]) Déclenche l'événement d' ObjectChanged au sein d'un groupe spécifié d'événements.
Méthode publique RaiseObjectChanged(String, array<Object[], array<Object[]) Déclenche un événement autonome d' ObjectChanged pour un objet dont l'identificateur a été modifié pendant la modification.
Méthode publique RaiseObjectChanged(Int32, String, array<Object[], array<Object[]) Déclenche un événement d' ObjectChanged au sein d'un groupe spécifique d'événements pour un objet dont l'identificateur a été modifié pendant la modification.
Méthode publique RaiseObjectRemoved(String, array<Object[]) Déclenche un événement autonome d' ObjectRemoved , en spécifiant le nom et identificateur d'objet.
Méthode publique RaiseObjectRemoved(Int32, String, array<Object[]) Déclenche l'événement d' ObjectRemoved au sein d'un groupe spécifié d'événements.
Méthode publique RollbackEventGroup Met fin à un groupe d'événements en supprimant le jeu d'événements en file d'attente du groupe.
Méthode publique StartEventGroup Commence un groupe d'événements initialisés par un appel à la méthode d' StartEventGroup .
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)

Début

Événements

  Nom Description
Événement public EventGroupEnded Événement déclenché lorsqu'un groupe d'événements est terminé.
Événement public EventGroupStarted Événement déclenché lorsqu'un groupe d'événements a démarré.
Événement public ObjectAdded Événement déclenché lorsqu'un objet de données a été ajouté.
Événement public ObjectChanged Événement déclenché lorsqu'un objet de données a été modifié.
Événement public ObjectRemoved Événement déclenché lorsqu'un objet de données a été supprimé.

Début

Notes

Outre les événements singuliers, cette classe vous permet aux groupes d'événements de structure.

Dans certaines circonstances, plusieurs événements de modification doivent être regroupés et soient traités comme transaction atomique.

Normalement, un écouteur d'événements réagit aux notifications d'événements groupe en assemblage une file d'attente des événements déclenchés à l'intérieur d'un groupe d'événement ; ensuite, uniquement après que la notification que le groupe d'événements est terminée, sont les événements effectue en mode transactionnels (autrement dit, tous les événements s'appliquent, ou aucun des événements ne s'applique).

Du côté de notification, le regroupement d'événements est implémenté en activant la spécification d'une hiérarchie de groupes d'événements, chacun d'eux marquée avec un ID groupe.Un auteur de la notification démarre en appelant StartEventGroup, qui retourne un ID du groupe.L'auteur de la notification appelle [M:Microsoft.VisualStudio.Data.DataObjectChangeEvents.RaiseObjectAdded(System.String,System.Object[]],RaiseObjectChanged, et des méthodes d' RaiseObjectRemoved , en passant l'ID groupe.(Éventuellement, un auteur de la notification permet de démarrer un groupe incorporé d'événement en appelant StartEventGroup de nouveau, avec l'ID groupe actuelle.)

Finally l'auteur de la notification appelle EndEventGroup à l'aide de l'ID groupe.Une fois le groupe supérieur (le groupe créé en appelant StartEventGroup avec un paramètre de zéro) est terminé, tous les événements déclenchés pour ce groupe sont distribués aux écouteurs à un groupe unique d'événements.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.Data, espace de noms

DataObjectChangedEventHandler

DataObjectChangedEventArgs