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.
Commence un groupe d'événements initialisés par un appel à 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 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 : System.Int32
L'ID groupe parent éventuelle ; sinon zéro.
Valeur de retour
Type : System.Int32
Retourne l'ID groupe du groupe parent.
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.