Partilhar via


EventHubReceiver.Receive Método

Definição

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

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

Exceções

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

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

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

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

Aplica-se a

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

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

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

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

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

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.

Aplica-se a

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

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

Exceções

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

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

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

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.

Aplica-se a

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

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

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

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

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

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.

Aplica-se a