Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Met fin à un groupe d'événements qui a été initialisé en appelant la méthode d' 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 : System.Int32
Un numéro d'ID pour le groupe spécifié d'événements.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | Le paramètre d' groupId est inférieur ou égal à 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 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 RaiseObjectAdded,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é .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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.