Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

DataObjectChangeEvents.StartEventGroup, méthode

Démarre un groupe d'événements initialisés par un appel à la méthode StartEventGroup.

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

public abstract int StartEventGroup(
	int groupId
)

Paramètres

groupId
Type : Int32

L'identification groupe parent cas échéant ; sinon zéro.

Valeur de retour

Type : Int32
Retourne l'ID groupe du groupe parent.

ExceptionCondition
ArgumentOutOfRangeException

Le paramètre groupId est inférieure ou égale à zéro ou est supérieur au nombre actuel de groupes alloués.

ArgumentException

Le paramètre groupId n'est pas valide.

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.

Afficher: