DataObjectChangeEvents.EndEventGroup – metoda
Ukončí skupinu událostí, která byla iniciována volání StartEventGroup metoda.
Obor názvů: Microsoft.VisualStudio.Data
Sestavení: Microsoft.VisualStudio.Data (v Microsoft.VisualStudio.Data.dll)
Syntaxe
'Deklarace
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
)
Parametry
- groupId
Typ: System.Int32
Číslo ID skupiny zadané události.
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 RaiseObjectRemoved metody 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á EndEventGrouppomocí 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.