Método DataObjectChangeEvents.EndEventGroup
Finaliza um grupo de evento que é iniciado chamando o método StartEventGroup .
Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)
Sintaxe
'Declaração
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
)
Parâmetros
groupId
Tipo: Int32Um número de identificação para o grupo especificado do evento.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentOutOfRangeException | O parâmetro de groupId é menor ou igual a zero ou é maior que o número atual de grupos atribuídos. |
| ArgumentException | O parâmetro groupId é inválido. |
Comentários
Em algumas circunstâncias, vários eventos de alteração precisam ser agrupados juntos e são tratados como uma transação atômica.
Normalmente, um evento ouvinte está notificações de evento grupo montando uma fila de eventos disparados dentro de um grupo do evento; em seguida, somente após a notificação que o grupo de evento finalizou, é eventos processados em uma maneira transacional (isto é, todos os eventos se aplicam, ou nenhum dos eventos se aplicam).
No lado de notificação, o agrupamento de evento é implementado ativando a especificação de uma hierarquia de grupos de evento, cada um deless identificar com uma identificação de grupo Um notificador começa chamando StartEventGroup, que retorna uma identificação para o grupo. No notificador chama RaiseObjectAdded,RaiseObjectChanged, e os métodos de RaiseObjectRemoved , passando em identificação de grupo (Opcionalmente, um notificador pode iniciar um grupo inserida de evento chamando StartEventGroup novamente, com a identificação do grupo atual)
Finalmente notificador chama o EndEventGroupusando a identificação do grupo Uma vez que o grupo top-most (grupo criado chamando StartEventGroup com um parâmetro de zero) finalizou, todos os eventos gerados para esse grupo são despachados para os ouvintes em um único grupo de evento.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.