EventHubConsumerGroup.CreateReceiver Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.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
Identificador de la partición.
- position
- EventPosition
A partir EventPosition del cual se empiezan a recibir mensajes.
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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingDateTimeUtc As DateTime, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, offsetInclusive As Boolean, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.EventHubReceiverPublic Function CreateReceiver (partitionId As String, startingOffset As String, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As EventHubReceiverPará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.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
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
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de