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)
Syntaxe
'Déclaration
Public MustOverride Function StartEventGroup ( _
groupId As Integer _
) As Integer
public abstract int StartEventGroup(
int groupId
)
public:
virtual int StartEventGroup(
int groupId
) abstract
abstract StartEventGroup :
groupId:int -> int
public abstract function StartEventGroup(
groupId : int
) : int
Paramètres
groupId
Type : Int32L'identification groupe parent cas échéant ; sinon zéro.
Valeur de retour
Type : Int32
Retourne l'ID groupe du groupe parent.
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.