EventHubConsumerGroup.CreateReceiver Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.
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 à
Azure SDK for .NET