Compartir a través de


EventHubConsumerGroup.CreateReceiver Método

Definición

Sobrecargas

CreateReceiver(String, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, DateTime, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, empezando por la fecha y hora especificadas. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada y el valor de época especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, String, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en la posición inicial especificada. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, DateTime, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, empezando por la fecha y hora especificadas. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, String, Boolean, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, String, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado.

CreateReceiver(String, String, Boolean, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, especificada por partitionId.

CreateReceiver(String, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve el EventHubReceiver objeto asociado a la partición de Event Hubs especificada.

Excepciones

Se produce si el servicio encuentra un error transitorio.

Se produce si el cliente tiene un problema al conectarse al servicio.

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Se produce si el número de receptores conectados actualmente a la partición especificada por partitionId ha superado la cuota máxima permitida establecida por el servicio.

Se produce si actualmente hay un receptor conectado a la partición según lo especificado por partitionId.

Comentarios

Si tiene habilitado el EventHubConsumerGroup punto de control, esta sobrecarga siempre generará InvalidOperationException porque el punto de control habilitado para ConsumerGroup requiere que la época funcione (use la sobrecarga que proporciona la época como argumento de entrada). Si el punto de control está deshabilitado, el receptor recibirá el mensaje desde el principio de la secuencia de eventos, según lo determinado por la directiva de retención de mensajes del centro de eventos.

Se aplica a

CreateReceiver(String, DateTime, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, empezando por la fecha y hora especificadas. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

startingDateTimeUtc
DateTime

Hora UTC inicial para recibir mensajes.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Excepciones

Se produce si el servicio encuentra un error transitorio.

Se produce si el cliente tiene un problema al conectarse al servicio.

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Se produce si el número de receptores conectados actualmente a la partición especificada por partitionId ha superado la cuota máxima permitida establecida por el servicio.

Se produce si actualmente hay un receptor conectado a la partición tal y como especifica partitionId, con un startingDateTimeUtc especificado.

Comentarios

El servicio solo lo startingDateTimeUtc usa como aproximación al determinar el siguiente evento que se va a entregar.

Tenga en cuenta que puede haber asimetría de reloj entre la hora del cliente y la hora del servicio, por lo que la aplicación de usuario debe diseñarse para controlar la duplicación en la entrega de eventos.

Se aplica a

CreateReceiver(String, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada y el valor de época especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

epoch
Int64

Valor de época. El servicio usa este valor para aplicar la propiedad de partición o concesión.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Excepciones

Se produce si el servicio encuentra un error transitorio.

Se produce si el cliente tiene un problema al conectarse al servicio.

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Comentarios

Si el EventHubConsumerGroup control tiene habilitado el punto de control, el receptor recibirá el siguiente mensaje del desplazamiento del punto de control. Si el punto de control está deshabilitado, el receptor recibirá el mensaje desde el principio de la secuencia de eventos, según lo determinado por la directiva de retención de mensajes del centro de eventos.

Se aplica a

CreateReceiver(String, String, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

startingOffset
String

Desplazamiento inicial en el que se empieza a recibir mensajes.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Excepciones

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Se produce si el número de receptores conectados actualmente a la partición especificada por partitionId ha superado la cuota máxima permitida establecida por el servicio.

Se produce si actualmente hay un receptor conectado a la partición tal y como especifica partitionId, con un startingOffset especificado.

Se aplica a

CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en la posición inicial especificada. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

position
EventPosition

A partir EventPosition del cual se empiezan a recibir mensajes.

epoch
Nullable<Int64>

Valor de época. Si se establece, el servicio usa este valor para aplicar la propiedad de partición o concesión.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Se aplica a

CreateReceiver(String, DateTime, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, empezando por la fecha y hora especificadas. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

startingDateTimeUtc
DateTime

Hora UTC inicial para recibir mensajes.

epoch
Int64

Valor de época. El servicio usa este valor para aplicar la propiedad de partición o concesión.

receiverOptions
ReceiverOptions

Opciones de un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Excepciones

Se produce si el servicio encuentra un error transitorio.

Se produce si el cliente tiene un problema al conectarse al servicio.

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Comentarios

El servicio solo lo startingDateTimeUtc usa como aproximación al determinar el siguiente evento que se va a entregar.

Tenga en cuenta que puede haber asimetría de reloj entre la hora del cliente y la hora del servicio, por lo que la aplicación de usuario debe diseñarse para controlar la duplicación en la entrega de eventos.

Se aplica a

CreateReceiver(String, String, Boolean, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

startingOffset
String

Desplazamiento inicial en el que se empiezan a recibir mensajes.

offsetInclusive
Boolean

Valor booleano que indica si startingOffset se trata como un desplazamiento inclusivo, lo que significa que la primera opción para un receptor del centro de eventos. el evento devuelto es el evento que contiene el desplazamiento inicial. Normalmente, el primer evento devuelto es el evento después del desplazamiento inicial.

receiverOptions
ReceiverOptions

Devoluciones

Devuelve EventHubReceiver.

Se aplica a

CreateReceiver(String, String, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento 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

Identificador de la partición.

startingOffset
String

Desplazamiento inicial en el que se empiezan a recibir mensajes. Para especificar el inicio de la secuencia, vea StartOfStream.

epoch
Int64

Valor de época. El servicio usa este valor para aplicar la propiedad de partición o concesión.

receiverOptions
ReceiverOptions

Opciones para un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Excepciones

Se produce si el servicio encuentra un error transitorio.

Se produce si el cliente tiene un problema al conectarse al servicio.

Se produce si partitionId no está dentro del intervalo esperado, según lo determinado por la PartitionCount propiedad .

Se aplica a

CreateReceiver(String, String, Boolean, Int64, ReceiverOptions)

Crea un nuevo receptor de Event Hubs en la partición especificada, en el desplazamiento inicial especificado. Puede usar el receptor creado para recibir eventos de una partición de Event Hubs, 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

Identificador de la partición.

startingOffset
String

Desplazamiento inicial en el que se empiezan a recibir mensajes.

offsetInclusive
Boolean

Valor booleano que indica si startingOffset se trata como un desplazamiento inclusivo, lo que significa que el primer evento devuelto es el evento que contiene el desplazamiento inicial. Normalmente, el primer evento devuelto es el evento después del desplazamiento inicial.

epoch
Int64

Valor de época. El servicio usa este valor para aplicar la propiedad de partición o concesión.

receiverOptions
ReceiverOptions

Opciones para un receptor de centro de eventos.

Devoluciones

Devuelve EventHubReceiver.

Se aplica a