Partager via


EventHubConsumerGroup.CreateReceiver Méthode

Définition

Surcharges

CreateReceiver(String, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, DateTime, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, à partir de la date et de l’heure spécifiées. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée et la valeur d’époque spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, String, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

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

Crée un récepteur Event Hubs dans la partition spécifiée, à la position de départ spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, DateTime, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, à partir de la date et de l’heure spécifiées. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, String, Boolean, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, String, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié.

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

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par partitionId.

CreateReceiver(String, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l’objet EventHubReceiver lié à la partition Event Hubs donnée.

Exceptions

Levée si le service rencontre une erreur temporaire.

Levée si le client rencontre un problème de connexion au service.

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

Levée si le nombre de récepteurs actuellement connectés à la partition spécifiée par partitionId a dépassé le quota maximal autorisé défini par le service.

Levée s’il existe actuellement un récepteur connecté à la partition comme spécifié par partitionId.

Remarques

Si le point de EventHubConsumerGroup contrôle est activé, cette surcharge lève toujours InvalidOperationException, car le point de contrôle avec ConsumerGroup nécessite le fonctionnement de l’époque (utilisez la surcharge qui fournit l’époque comme argument d’entrée). Si le point de contrôle est désactivé, le récepteur obtient le message dès le début du flux d’événements, comme déterminé par la stratégie de rétention des messages de l’Event Hub.

S’applique à

CreateReceiver(String, DateTime, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, à partir de la date et de l’heure spécifiées. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

startingDateTimeUtc
DateTime

Heure UTC de début de la réception des messages.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l'EventHubReceiver.

Exceptions

Levée si le service rencontre une erreur temporaire.

Levée si le client rencontre un problème de connexion au service.

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

Levée si le nombre de récepteurs actuellement connectés à la partition spécifiée par partitionId a dépassé le quota maximal autorisé défini par le service.

Levée s’il existe actuellement un récepteur connecté à la partition comme spécifié par partitionId, avec un startingDateTimeUtc spécifié.

Remarques

Le service l’utilise startingDateTimeUtc uniquement comme approximation lors de la détermination de l’événement suivant à remettre.

Gardez à l’esprit qu’il peut y avoir un décalage d’horloge entre l’heure du client et l’heure du service, de sorte que l’application utilisateur doit être conçue pour gérer la duplication dans la remise d’événements.

S’applique à

CreateReceiver(String, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée et la valeur d’époque spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

epoch
Int64

Valeur d’époque. Le service utilise cette valeur pour appliquer la propriété de la partition/du bail.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l'EventHubReceiver.

Exceptions

Levée si le service rencontre une erreur temporaire.

Levée si le client rencontre un problème de connexion au service.

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

Remarques

Si le point de EventHubConsumerGroup contrôle est activé, le destinataire obtient le message suivant à partir du décalage du point de contrôle. Si le point de contrôle est désactivé, le récepteur obtient le message dès le début du flux d’événements, comme déterminé par la stratégie de rétention des messages du hub d’événements.

S’applique à

CreateReceiver(String, String, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

startingOffset
String

Décalage de départ auquel commencer à recevoir des messages.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l'EventHubReceiver.

Exceptions

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

Levée si le nombre de récepteurs actuellement connectés à la partition spécifiée par partitionId a dépassé le quota maximal autorisé défini par le service.

Levée s’il existe actuellement un récepteur connecté à la partition comme spécifié par partitionId, avec un startingOffset spécifié.

S’applique à

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

Crée un récepteur Event Hubs dans la partition spécifiée, à la position de départ spécifiée. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

position
EventPosition

à partir EventPosition duquel commencer à recevoir des messages.

epoch
Nullable<Int64>

Valeur d’époque. Si elle est définie, le service utilise cette valeur pour appliquer la propriété de la partition/du bail.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne EventHubReceiver.

S’applique à

CreateReceiver(String, DateTime, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, à partir de la date et de l’heure spécifiées. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

startingDateTimeUtc
DateTime

Heure UTC de début de la réception des messages.

epoch
Int64

Valeur d’époque. Le service utilise cette valeur pour appliquer la propriété de la partition/du bail.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l'EventHubReceiver.

Exceptions

Levée si le service rencontre une erreur temporaire.

Levée si le client rencontre un problème de connexion au service.

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

Remarques

Le service l’utilise startingDateTimeUtc uniquement comme approximation lors de la détermination de l’événement suivant à remettre.

Gardez à l’esprit qu’il peut y avoir un décalage d’horloge entre l’heure du client et l’heure du service, de sorte que l’application utilisateur doit être conçue pour gérer la duplication dans la remise d’événements.

S’applique à

CreateReceiver(String, String, Boolean, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

startingOffset
String

Décalage de départ auquel commencer à recevoir des messages.

offsetInclusive
Boolean

Valeur booléenne qui indique si startingOffset est traité comme un décalage inclusif, ce qui signifie que les premières options d’un récepteur event hub. l’événement retourné est l’événement qui contient le décalage de départ. Normalement, le premier événement retourné est l’événement après le décalage de début.

receiverOptions
ReceiverOptions

Retours

Retourne EventHubReceiver.

S’applique à

CreateReceiver(String, String, Int64, ReceiverOptions)

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié.

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

Paramètres

partitionId
String

ID de la partition.

startingOffset
String

Décalage de départ auquel commencer à recevoir des messages. Pour spécifier le début du flux, consultez StartOfStream.

epoch
Int64

Valeur d’époque. Le service utilise cette valeur pour appliquer la propriété de la partition/du bail.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne l'EventHubReceiver.

Exceptions

Levée si le service rencontre une erreur temporaire.

Levée si le client rencontre un problème de connexion au service.

Levée si partitionId n’est pas dans la plage attendue, comme déterminé par la PartitionCount propriété .

S’applique à

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

Crée un récepteur Event Hubs dans la partition spécifiée, au décalage de départ spécifié. Vous pouvez utiliser le récepteur créé pour recevoir des événements pour une partition Event Hubs, spécifiée par 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

Paramètres

partitionId
String

ID de la partition.

startingOffset
String

Décalage de départ auquel commencer à recevoir des messages.

offsetInclusive
Boolean

Valeur booléenne qui indique si startingOffset est traité comme un décalage inclusif, ce qui signifie que le premier événement retourné est l’événement qui contient le décalage de départ. Normalement, le premier événement retourné est l’événement après le décalage de début.

epoch
Int64

Valeur d’époque. Le service utilise cette valeur pour appliquer la propriété de la partition/du bail.

receiverOptions
ReceiverOptions

Options pour un récepteur event hub.

Retours

Retourne EventHubReceiver.

S’applique à