DataObjectChangeEvents, classe

Fournit un ensemble d'événements qu'un fournisseur de DDEX peut déclencher lorsque les objets de données sont apportées, et fournit le moyen lesquels un fournisseur peut se connecter à eux.

Hiérarchie d'héritage

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 Constructeurs de classe.Instancie une nouvelle instance de la classe DataObjectChangeEvents.

Début

Méthodes

  Nom Description
Méthode publique EndEventGroup Termine un groupe d'événement qui a été initialisé en appelant la méthode 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 à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. (Hérité de Object.)
Méthode publique GetHashCode Sert de fonction de hachage par défaut. (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 du Object actuel. (Hérité de Object.)
Méthode protégée OnEventGroupEnded Gestionnaire pour l'événement EventGroupEnded.
Méthode protégée OnEventGroupStarted Gestionnaire pour l'événement EventGroupStarted.
Méthode protégée OnObjectAdded Gestionnaire pour l'événement ObjectAdded.
Méthode protégée OnObjectChanged Gestionnaire pour l'événement ObjectChanged.
Méthode protégée OnObjectRemoved Gestionnaire pour l'événement ObjectRemoved.
Méthode publique RaiseObjectAdded(String, array<Object[]) Déclenche un événement ObjectAdded autonome, en spécifiant le type d'objet et l'identificateur.
Méthode publique RaiseObjectAdded(Int32, String, array<Object[]) Déclenche l'événement ObjectAdded dans un groupe d'événement spécifique.
Méthode publique RaiseObjectChanged(String, array<Object[]) Déclenche un événement ObjectChanged autonome, en spécifiant le nom de type et l'identificateur.
Méthode publique RaiseObjectChanged(Int32, String, array<Object[]) Déclenche l'événement ObjectChanged dans un groupe spécifié d'événement.
Méthode publique RaiseObjectChanged(String, array<Object[], array<Object[]) Déclenche un événement ObjectChanged autonome 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 ObjectChanged dans un groupe spécifique d'événement pour un objet dont l'identificateur a été modifié pendant la modification.
Méthode publique RaiseObjectRemoved(String, array<Object[]) Déclenche un événement ObjectRemoved autonome, en spécifiant le nom de type et l'identificateur d'objet.
Méthode publique RaiseObjectRemoved(Int32, String, array<Object[]) Déclenche l'événement ObjectRemoved dans un groupe spécifié d'événement.
Méthode publique RollbackEventGroup Termine un groupe d'événement en supprimant le jeu d'événements en file d'attente du groupe.
Méthode publique StartEventGroup Démarre un groupe d'événements initialisés par un appel à la méthode 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énement terminé.
Événement public EventGroupStarted Événement déclenché lorsqu'un groupe d'événement a commencé.
É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 au singulier, cette classe vous permet aux groupes de structure.

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

Normalement, un écouteur d'événements réagit aux notifications d'événement groupe en assemblant par une file d'attente des événements déclenchés dans un groupe d'événement ; ensuite, uniquement après que la notification que le groupe d'événement a terminée, assurez 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énement est implémenté en vérifiant la spécification d'une hiérarchie de groupes d'événement, chacun d'eux marquée avec un ID groupe. Un auteur de la notification commence en appelant StartEventGroup, qui retourne un ID pour le groupe. Puis l'auteur de la notification appelle RaiseObjectAdded,RaiseObjectChanged, et les méthodes RaiseObjectRemoved, en passant l'ID groupe. (Éventuellement, un auteur de la notification peut démarrer un groupe incorporé d'événement en appelant StartEventGroup de nouveau, avec l'ID groupe actuelle.)

Enfin l'auteur de la notification appelle EndEventGroup à l'identification 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 pour un groupe d'événement.

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