DataObjectChangeEvents.StartEventGroup - метод

Статья
05/17/2015

Запускает команды в составе события в ответ на вызов метода StartEventGroup.

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

Синтаксис

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

Параметры

groupId
Тип: Int32

Родительское идентификатор группы, если таковые имеются; в противном случае ноль.

Возвращаемое значение

Тип: Int32
Возвращает идентификатор группы родительской группы.

Исключения

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

Заметки

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

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

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

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

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

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

См. также

Ссылки

DataObjectChangeEvents Класс

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

DataObjectChangeEvents

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