DataObjectChangeEvents.EndEventGroup - метод

Статья
05/17/2015

Команда выполнит события, которая была начата, вызвав метод StartEventGroup.

Пространство имен: Microsoft.VisualStudio.Data
Сборка: Microsoft.VisualStudio.Data (в Microsoft.VisualStudio.Data.dll)

Синтаксис

'Декларация
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
)

Параметры

groupId
Тип: Int32

Идентификатор для определенной группы событий.

Исключения

Исключение	Условие
ArgumentOutOfRangeException	Параметр groupId меньше или равно нулю, либо больше, чем количество выбранных групп.
ArgumentException	Параметр groupId недопустим.

Заметки

В некоторых случаях нескольких события изменения должны быть группированным вместе и обрабатывались в результате атомарной транзакции.

Обычно прослушивателя событий реагирует на события уведомления группы путем сбора очередь событий мыши внутри группы события; затем, только после уведомления, команда события завершения события, обрабатываемые в деловом способом (т е все события применяются, либо ни одно из событий применяются).

На стороне уведомления, команда события реализуется путем включения спецификацию иерархии групп событий, каждой из них задан с идентификатором группы. Notifier начинается с вызова StartEventGroup, который возвращает идентификатор для группы. Затем notifier вызывает RaiseObjectAdded,RaiseObjectChanged и методы RaiseObjectRemoved, передавая идентификатор группы. (Дополнительно notifier может запустить вложенную команда события путем вызова StartEventGroup снова, с текущим идентификатором группы).

Наконец notifier вызывает EndEventGroup использование идентификатор группы. После того как команда находится на самом верхнем уровне (созданная команда путем вызова StartEventGroup с параметром ноль) заканчивается, все события, вызванные для этой группы перенаправляются в прослушиватели в одной группе событий.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.

См. также

Ссылки

DataObjectChangeEvents Класс

Microsoft.VisualStudio.Data - пространство имен

Поделиться через