EventHubConsumerGroup.CreateReceiver Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CreateReceiver(String, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, DateTime, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, começando na data e hora especificadas.
Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, Int64, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada e o valor de época especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, String, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, na posição inicial especificada. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, DateTime, Int64, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, começando na data e hora especificadas.
Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, String, Boolean, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
| CreateReceiver(String, String, Int64, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. |
| CreateReceiver(String, String, Boolean, Int64, ReceiverOptions) |
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por |
CreateReceiver(String, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver objeto que está vinculado à partição dos Hubs de Eventos fornecida.
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.
Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.
Gerado se houver atualmente um receptor conectado à partição, conforme especificado por partitionId.
Comentários
Se o tiver o EventHubConsumerGroup ponto de verificação habilitado, essa sobrecarga sempre gerará InvalidOperationException porque ConsumerGroup habilitado para ponto de verificação requer que a época funcione (use a sobrecarga que fornece época como argumento de entrada). Se o ponto de verificação estiver desabilitado, o receptor receberá a mensagem desde o início do fluxo de eventos, conforme determinado pela política de retenção de mensagens do Hub de Eventos.
Aplica-se a
CreateReceiver(String, DateTime, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, começando na data e hora especificadas.
Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, DateTime startingDateTimeUtc, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * DateTime * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingDateTimeUtc
- DateTime
A hora UTC inicial para receber mensagens.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver.
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.
Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.
Gerado se houver atualmente um receptor conectado à partição, conforme especificado por partitionId, com um startingDateTimeUtc especificado.
Comentários
O serviço usa isso startingDateTimeUtc apenas como uma aproximação ao determinar o próximo evento a ser entregue.
Tenha em mente que pode haver distorção de relógio entre a hora do cliente e a hora do serviço, portanto, o aplicativo do usuário deve ser projetado para lidar com a duplicação na entrega de eventos.
Aplica-se a
CreateReceiver(String, Int64, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada e o valor de época especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, long epoch, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * int64 * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- epoch
- Int64
O valor da época. O serviço usa esse valor para impor a propriedade de partição/concessão.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver.
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.
Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Comentários
Se o tiver o EventHubConsumerGroup ponto de verificação habilitado, o receptor receberá a próxima mensagem do deslocamento do ponto de verificação. Se o ponto de verificação estiver desabilitado, o receptor receberá a mensagem desde o início do fluxo de eventos, conforme determinado pela política de retenção de mensagens do hub de eventos.
Aplica-se a
CreateReceiver(String, String, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, string startingOffset, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * string * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingOffset
- String
O deslocamento inicial no qual começar a receber mensagens.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver.
Exceções
Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.
Gerado se houver atualmente um receptor conectado à partição, conforme especificado por partitionId, com um startingOffset especificado.
Aplica-se a
CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, na posição inicial especificada. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, Microsoft.ServiceBus.Messaging.EventPosition position, long? epoch = default, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * Microsoft.ServiceBus.Messaging.EventPosition * Nullable<int64> * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, position As EventPosition, Optional epoch As Nullable(Of Long) = Nothing, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- position
- EventPosition
O que começa EventPosition no qual começar a receber mensagens.
O valor da época. Se definido, o serviço usará esse valor para impor a propriedade de partição/concessão.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna EventHubReceiver.
Aplica-se a
CreateReceiver(String, DateTime, Int64, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, começando na data e hora especificadas.
Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, DateTime startingDateTimeUtc, long epoch, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * DateTime * int64 * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingDateTimeUtc
- DateTime
A hora UTC inicial para receber mensagens.
- epoch
- Int64
O valor da época. O serviço usa esse valor para impor a propriedade de partição/concessão.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver.
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.
Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Comentários
O serviço usa isso startingDateTimeUtc apenas como uma aproximação ao determinar o próximo evento a ser entregue.
Tenha em mente que pode haver distorção de relógio entre a hora do cliente e a hora do serviço, portanto, o aplicativo do usuário deve ser projetado para lidar com a duplicação na entrega de eventos.
Aplica-se a
CreateReceiver(String, String, Boolean, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, string startingOffset, bool offsetInclusive, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * string * bool * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, offsetInclusive As Boolean, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingOffset
- String
O deslocamento inicial no qual começar a receber mensagens.
- offsetInclusive
- Boolean
Um valor booliano que indica se startingOffset é tratado como um deslocamento inclusivo, o que significa que as primeiras Opções para um receptor de hub de eventos. o evento retornado é o evento que contém o deslocamento inicial. Normalmente, o primeiro evento retornado é o evento após o deslocamento inicial.
- receiverOptions
- ReceiverOptions
Retornos
Retorna EventHubReceiver.
Aplica-se a
CreateReceiver(String, String, Int64, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, string startingOffset, long epoch, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * string * int64 * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingOffset
- String
O deslocamento inicial no qual começar a receber mensagens. Para especificar o início do fluxo, consulte StartOfStream.
- epoch
- Int64
O valor da época. O serviço usa esse valor para impor a propriedade de partição/concessão.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna o EventHubReceiver.
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 partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .
Aplica-se a
CreateReceiver(String, String, Boolean, Int64, ReceiverOptions)
Cria um novo receptor dos Hubs de Eventos na partição especificada, no deslocamento inicial especificado. Você pode usar o receptor criado para receber eventos para uma partição de Hubs de Eventos, especificada por partitionId.
public Microsoft.ServiceBus.Messaging.EventHubReceiver CreateReceiver (string partitionId, string startingOffset, bool offsetInclusive, long epoch, Microsoft.ServiceBus.Messaging.ReceiverOptions receiverOptions = default);member this.CreateReceiver : string * string * bool * int64 * Microsoft.ServiceBus.Messaging.ReceiverOptions -> Microsoft.ServiceBus.Messaging.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, offsetInclusive As Boolean, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverParâmetros
- partitionId
- String
A ID da partição.
- startingOffset
- String
O deslocamento inicial no qual começar a receber mensagens.
- offsetInclusive
- Boolean
Um valor booliano que indica se startingOffset é tratado como um deslocamento inclusivo, o que significa que o primeiro evento retornado é o evento que contém o deslocamento inicial. Normalmente, o primeiro evento retornado é o evento após o deslocamento inicial.
- epoch
- Int64
O valor da época. O serviço usa esse valor para impor a propriedade de partição/concessão.
- receiverOptions
- ReceiverOptions
Opções para um receptor do hub de eventos.
Retornos
Retorna EventHubReceiver.
Aplica-se a
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários