DataObjectChangeEvents.StartEventGroup – metoda
Skupina událostí volání iniciováno začíná StartEventGroup metoda.
Obor názvů: Microsoft.VisualStudio.Data
Sestavení: Microsoft.VisualStudio.Data (v Microsoft.VisualStudio.Data.dll)
Syntaxe
'Deklarace
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
Parametry
- groupId
Typ: System.Int32
ID nadřazené skupiny: jinak nula.
Vrácená hodnota
Typ: System.Int32
Vrátí ID skupiny nadřazené skupiny.
Výjimky
| Výjimka | Podmínka |
|---|---|
| ArgumentOutOfRangeException | groupId Parametr je menší než nula nebo větší než aktuální počet přidělených skupin. |
| ArgumentException | groupId Parametr je neplatný. |
Poznámky
Za určitých okolností třeba více události změny seskupeny dohromady a považovány za atomické transakce.
Obvykle posluchač události reaguje na oznámení událostí skupiny sloučením fronta událostí vyvolaných uvnitř skupinu událostí; poté až po oznámení událostí skupiny skončila události zpracovány způsobem transakční (, použije všechny události nebo žádné události použít).
Na straně oznámení událostí seskupení je implementována povolením specifikace hierarchii skupin událostí, každý z nich označen ID skupiny.Oznamovatel začíná voláním StartEventGroup , která vrací ID pro skupinu.Potom oznamovatel volání RaiseObjectAdded,RaiseObjectChanged, a RaiseObjectRemovedmetody předávání v ID skupiny.(Volitelně oznamovatel skupinu událostí spustit voláním StartEventGroup opět s aktuální ID skupiny)
Nakonec oznamovatel volá EndEventGroup pomocí ID skupiny.Jednou nahoře skupina (skupiny vytvořené voláním StartEventGroup s parametrem nula) skončila, všech událostí vyvolaných této skupiny jsou odesílány do posluchačů ve skupině jediná událost.
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.