Sdílet prostřednictvím


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

Viz také

Referenční dokumentace

DataObjectChangeEvents Třída

Microsoft.VisualStudio.Data – obor názvů