Método DataObjectChangeEvents.EndEventGroup
Finaliza um grupo de evento que é lançado chamando o método de 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: System.Int32
Um 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 de 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 atomic
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, os eventos são processados em uma maneira transacional (isto é, todos os eventos se aplicam, ou nenhum dos eventos se aplicam).
Em o lado de notificação, o agrupamento de evento é implementado ativando a especificação de uma hierarquia de grupos de evento, cada um de eles identificar com uma identificação de grupoUm notificador começa chamando StartEventGroup, que retorna uma identificação para o grupo.Em o notificador chama RaiseObjectAdded,RaiseObjectChanged, os métodos e 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 ID do grupoUma vez que o grupo top-most grupo (chamando StartEventGroup criado 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áveis.