EventHubConsumerGroup.CreateReceiver Método

Definição

Namespace:

Microsoft.ServiceBus.Messaging

Assembly:

Microsoft.ServiceBus.dll

Pacote:

WindowsAzure.ServiceBus v6.2.2

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 partitionId.
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.
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.
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.
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.
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.
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.
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 partitionId.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâmetros

partitionId

String

A ID da partição.

receiverOptions

ReceiverOptions

Opções para um receptor do hub de eventos.

Retornos

EventHubReceiver

Retorna o EventHubReceiver objeto que está vinculado à partição dos Hubs de Eventos fornecida.

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.

ArgumentOutOfRangeException

Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .

QuotaExceededException

Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.

ReceiverDisconnectedException

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.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna o EventHubReceiver.

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.

ArgumentOutOfRangeException

Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .

QuotaExceededException

Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.

ReceiverDisconnectedException

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.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna o EventHubReceiver.

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.

ArgumentOutOfRangeException

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.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingOffset As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna o EventHubReceiver.

Exceções

ArgumentOutOfRangeException

Gerada se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .

QuotaExceededException

Gerado se o número de receptores atualmente conectados à partição especificada por partitionId excedeu a cota máxima permitida definida pelo serviço.

ReceiverDisconnectedException

Gerado se houver atualmente um receptor conectado à partição, conforme especificado por partitionId, com um startingOffset especificado.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, position As EventPosition, Optional epoch As Nullable(Of Long) = Nothing, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâmetros

partitionId

String

A ID da partição.

position

EventPosition

O que começa EventPosition no qual começar a receber mensagens.

epoch

Nullable<Int64>

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

EventHubReceiver

Retorna EventHubReceiver.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna o EventHubReceiver.

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.

ArgumentOutOfRangeException

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.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingOffset As String, offsetInclusive As Boolean, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna EventHubReceiver.

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingOffset As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna o EventHubReceiver.

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.

ArgumentOutOfRangeException

Gerado se partitionId não estiver dentro do intervalo esperado, conforme determinado pela PartitionCount propriedade .

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.EventHubReceiver

Public Function CreateReceiver (partitionId As String, startingOffset As String, offsetInclusive As Boolean, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiver

Parâ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

EventHubReceiver

Retorna EventHubReceiver.