EventHubReceiver.Receive Método

Definição

Namespace:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Pacote:

WindowsAzure.ServiceBus v6.2.2

Sobrecargas

Receive()	Recebe dados de eventos dos Hubs de Eventos.
Receive(Int32)	Recebe dados de evento dos Hubs de Eventos, até a contagem especificada.
Receive(TimeSpan)	Recebe dados de evento dos Hubs de Eventos com o valor de tempo limite especificado.
Receive(Int32, TimeSpan)	Recebe dados de evento dos Hubs de Eventos, até a contagem especificada com o valor de tempo limite especificado.

Receive()

Recebe dados de eventos dos Hubs de Eventos.

public Microsoft.ServiceBus.Messaging.EventData Receive ();

member this.Receive : unit -> Microsoft.ServiceBus.Messaging.EventData

Public Function Receive () As EventData

Retornos

EventData

Retorna o objeto recebido EventData ou nulo se nenhum dado de evento estiver disponível.

Exceções

MessagingException

Gerado se o serviço encontrar um erro transitório.

MessagingCommunicationException

Gerado se o cliente tiver um problema ao se conectar ao serviço.

ServerBusyException

Gerado se o namespace atual estiver colocando muita carga no sistema.

ReceiverDisconnectedException

Gerado se outro receptor com um valor mais alto Epoch estiver conectado como o receptor atual à mesma partição especificada por PartitionId.

Receive(Int32)

Recebe dados de evento dos Hubs de Eventos, até a contagem especificada.

public System.Collections.Generic.IEnumerable<Microsoft.ServiceBus.Messaging.EventData> Receive (int maxCount);

member this.Receive : int -> seq<Microsoft.ServiceBus.Messaging.EventData>

Public Function Receive (maxCount As Integer) As IEnumerable(Of EventData)

Parâmetros

maxCount

Int32

A quantidade máxima de dados de evento que o usuário está disposto a aceitar em uma chamada.

Retornos

IEnumerable<EventData>

Retorna a coleção recebida EventData . A coleção estará vazia se nenhum evento for retornado dentro do tempo especificado ou todos os eventos até maxCount forem retornados.

Exceções

MessagingException

Gerado se o serviço encontrar um erro transitório.

MessagingCommunicationException

Gerado se o cliente tiver um problema ao se conectar ao serviço.

ServerBusyException

Gerado se o namespace atual estiver colocando muita carga no sistema.

ReceiverDisconnectedException

Gerado se outro receptor com um valor mais alto Epoch estiver conectado como o receptor atual à mesma partição especificada por PartitionId.

Comentários

O serviço não aguarda maxCount que os eventos sejam preenchidos antes de retornar ao usuário. Ele retorna assim que há eventos disponíveis.

Receive(TimeSpan)

Recebe dados de evento dos Hubs de Eventos com o valor de tempo limite especificado.

public Microsoft.ServiceBus.Messaging.EventData Receive (TimeSpan waitTime);

member this.Receive : TimeSpan -> Microsoft.ServiceBus.Messaging.EventData

Public Function Receive (waitTime As TimeSpan) As EventData

Parâmetros

waitTime

TimeSpan

O tempo máximo que o usuário está disposto a aguardar a chegada dos dados do evento.

Retornos

EventData

Retorna a coleção recebida EventData ou nulo se não houver dados de evento disponíveis.

Exceções

MessagingException

Gerado se o serviço encontrar um erro transitório.

MessagingCommunicationException

Gerado se o cliente tiver um problema ao se conectar ao serviço.

ServerBusyException

Gerado se o namespace atual estiver colocando muita carga no sistema.

ReceiverDisconnectedException

Gerado se outro receptor com um valor mais alto Epoch estiver conectado como o receptor atual à mesma partição especificada por PartitionId.

Comentários

waitTime não é um tempo de espera garantido, pois a API retornará dados assim que estiverem disponíveis.

Receive(Int32, TimeSpan)

Recebe dados de evento dos Hubs de Eventos, até a contagem especificada com o valor de tempo limite especificado.

public System.Collections.Generic.IEnumerable<Microsoft.ServiceBus.Messaging.EventData> Receive (int maxCount, TimeSpan waitTime);

member this.Receive : int * TimeSpan -> seq<Microsoft.ServiceBus.Messaging.EventData>

Public Function Receive (maxCount As Integer, waitTime As TimeSpan) As IEnumerable(Of EventData)

Parâmetros

maxCount

Int32

A quantidade máxima de dados de evento que o usuário está disposto a aceitar em uma chamada.

waitTime

TimeSpan

O tempo máximo que o usuário está disposto a aguardar a chegada dos dados do evento.

Retornos

IEnumerable<EventData>

Retorna a coleção recebida EventData . A coleção estará vazia se nenhum evento for retornado dentro do tempo especificado ou todos os eventos até maxCount forem retornados.

Exceções

MessagingException

Gerado se o serviço encontrar um erro transitório.

MessagingCommunicationException

Gerado se o cliente tiver um problema ao se conectar ao serviço.

ServerBusyException

Gerado se o namespace atual estiver colocando muita carga no sistema.

ReceiverDisconnectedException

Gerado se outro receptor com um valor mais alto Epoch estiver conectado como o receptor atual à mesma partição especificada por PartitionId.

Comentários

waitTime não é um tempo de espera garantido, pois a API retornará dados assim que estiverem disponíveis. Além disso, o serviço não aguarda maxCount que os eventos sejam preenchidos antes de retornar ao usuário. retorna assim que há eventos disponíveis.