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 | |
---|---|---|
DataObjectChangeEvents | Constructeur de classe.Instancie une nouvelle instance de la classe DataObjectChangeEvents. |
Début
Méthodes
Nom | Description | |
---|---|---|
EndEventGroup | Met fin à un groupe d'événements qui a été initialisé en appelant la méthode d' 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 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.) | |
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) | |
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) | |
MemberwiseClone | Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.) | |
OnEventGroupEnded | Gestionnaire pour l'événement d' EventGroupEnded . | |
OnEventGroupStarted | Gestionnaire pour l'événement d' EventGroupStarted . | |
OnObjectAdded | Gestionnaire pour l'événement d' ObjectAdded . | |
OnObjectChanged | Gestionnaire pour l'événement d' ObjectChanged . | |
OnObjectRemoved | Gestionnaire pour l'événement d' ObjectRemoved . | |
RaiseObjectAdded(String, array<Object[]) | Déclenche un événement autonome d' ObjectAdded , en spécifiant le type d'objet et l'identificateur. | |
RaiseObjectAdded(Int32, String, array<Object[]) | Déclenche l'événement d' ObjectAdded au sein d'un groupe d'événement spécifique. | |
RaiseObjectChanged(String, array<Object[]) | Déclenche un événement autonome d' ObjectChanged , en spécifiant le nom et identificateur. | |
RaiseObjectChanged(Int32, String, array<Object[]) | Déclenche l'événement d' ObjectChanged au sein d'un groupe spécifié d'événements. | |
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. | |
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. | |
RaiseObjectRemoved(String, array<Object[]) | Déclenche un événement autonome d' ObjectRemoved , en spécifiant le nom et identificateur d'objet. | |
RaiseObjectRemoved(Int32, String, array<Object[]) | Déclenche l'événement d' ObjectRemoved au sein d'un groupe spécifié d'événements. | |
RollbackEventGroup | Met fin à un groupe d'événements en supprimant le jeu d'événements en file d'attente du groupe. | |
StartEventGroup | Commence un groupe d'événements initialisés par un appel à la méthode d' 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énements est terminé. | |
EventGroupStarted | Événement déclenché lorsqu'un groupe d'événements a démarré. | |
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 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.