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 | |
---|---|---|
DataObjectChangeEvents | Constructeurs de classe.Instancie une nouvelle instance de la classe DataObjectChangeEvents. |
Début
Méthodes
Nom | Description | |
---|---|---|
EndEventGroup | Termine un groupe d'événement qui a été initialisé en appelant la méthode StartEventGroup. | |
Equals | Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.) | |
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.) | |
GetHashCode | Sert de fonction de hachage par défaut. (Hérité de Object.) | |
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) | |
MemberwiseClone | Crée une copie superficielle du Object actuel. (Hérité de Object.) | |
OnEventGroupEnded | Gestionnaire pour l'événement EventGroupEnded. | |
OnEventGroupStarted | Gestionnaire pour l'événement EventGroupStarted. | |
OnObjectAdded | Gestionnaire pour l'événement ObjectAdded. | |
OnObjectChanged | Gestionnaire pour l'événement ObjectChanged. | |
OnObjectRemoved | Gestionnaire pour l'événement ObjectRemoved. | |
RaiseObjectAdded(String, array<Object[]) | Déclenche un événement ObjectAdded autonome, en spécifiant le type d'objet et l'identificateur. | |
RaiseObjectAdded(Int32, String, array<Object[]) | Déclenche l'événement ObjectAdded dans un groupe d'événement spécifique. | |
RaiseObjectChanged(String, array<Object[]) | Déclenche un événement ObjectChanged autonome, en spécifiant le nom de type et l'identificateur. | |
RaiseObjectChanged(Int32, String, array<Object[]) | Déclenche l'événement ObjectChanged dans un groupe spécifié d'événement. | |
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. | |
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. | |
RaiseObjectRemoved(String, array<Object[]) | Déclenche un événement ObjectRemoved autonome, en spécifiant le nom de type et l'identificateur d'objet. | |
RaiseObjectRemoved(Int32, String, array<Object[]) | Déclenche l'événement ObjectRemoved dans un groupe spécifié d'événement. | |
RollbackEventGroup | Termine un groupe d'événement en supprimant le jeu d'événements en file d'attente du groupe. | |
StartEventGroup | Démarre un groupe d'événements initialisés par un appel à la méthode StartEventGroup. | |
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
Début
Événements
Nom | Description | |
---|---|---|
EventGroupEnded | Événement déclenché lorsqu'un groupe d'événement terminé. | |
EventGroupStarted | Événement déclenché lorsqu'un groupe d'événement a commencé. | |
ObjectAdded | Événement déclenché lorsqu'un objet de données a été ajouté. | |
ObjectChanged | Événement déclenché lorsqu'un objet de données a été modifié. | |
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.