Método DataObjectChangeEvents.StartEventGroup
Inicia um grupo de eventos iniciados por uma chamada para o método de StartEventGroup .
Namespace: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)
Sintaxe
'Declaração
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
Parâmetros
- groupId
Tipo: System.Int32
A identificação do grupo pai, se houver; se não zero.
Valor de retorno
Tipo: System.Int32
Retorna a identificação do grupo de grupo pai.
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 EndEventGroup usando 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.