DataObjectChangeEvents.EndEventGroup, méthode
Termine un groupe d'événement qui a été initialisé en appelant la méthode StartEventGroup.
Espace de noms : Microsoft.VisualStudio.Data
Assembly : Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)
Syntaxe
'Déclaration
Public MustOverride Sub EndEventGroup ( _
groupId As Integer _
)
public abstract void EndEventGroup(
int groupId
)
public:
virtual void EndEventGroup(
int groupId
) abstract
abstract EndEventGroup :
groupId:int -> unit
public abstract function EndEventGroup(
groupId : int
)
Paramètres
groupId
Type : Int32Un numéro d'ID du groupe spécifié d'événement.
Exceptions
| Exception | Condition |
|---|---|
| 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. |
Notes
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é .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.