EventHubConsumerGroup.CreateReceiver Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| CreateReceiver(String, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, DateTime, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition, beginnend am angegebenen Datum und der angegebenen Uhrzeit.
Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, Int64, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition und den angegebenen Epochenwert. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, String, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition an der angegebenen Startposition. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, DateTime, Int64, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition, beginnend am angegebenen Datum und der angegebenen Uhrzeit.
Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, String, Boolean, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
| CreateReceiver(String, String, Int64, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. |
| CreateReceiver(String, String, Boolean, Int64, ReceiverOptions) |
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird |
CreateReceiver(String, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt das EventHubReceiver Objekt zurück, das an die angegebene Event Hubs-Partition gebunden ist.
Ausnahmen
Wird ausgelöst, wenn für den Dienst ein vorübergehender Fehler auftritt.
Wird ausgelöst, wenn beim Client ein Problem beim Herstellen einer Verbindung mit dem Dienst auftritt.
Wird ausgelöst, wenn partitionId nicht innerhalb des erwarteten Bereichs liegt, der von der PartitionCount -Eigenschaft bestimmt wird.
Wird ausgelöst, wenn die Anzahl der Empfänger, die derzeit mit der angegebenen partitionId Partition verbunden sind, das vom Dienst festgelegte maximal zulässige Kontingent überschritten hat.
Wird ausgelöst, wenn derzeit ein Empfänger mit der Partition verbunden ist, wie durch partitionIdangegeben.
Hinweise
Wenn der EventHubConsumerGroup Prüfpunkt aktiviert ist, löst diese Überladung immer InvalidOperationException aus, da die consumerGroup für Prüfpunkte aktiviert ist, um eine Epoche zu funktionieren (verwenden Sie die Überladung, die Epoche als Eingabeargument bereitstellt). Wenn der Prüfpunkt deaktiviert ist, erhält der Empfänger eine Nachricht vom Anfang des Ereignisdatenstroms, wie durch die Nachrichtenaufbewahrungsrichtlinie des Event Hubs festgelegt.
Gilt für:
CreateReceiver(String, DateTime, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition, beginnend am angegebenen Datum und der angegebenen Uhrzeit.
Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingDateTimeUtc
- DateTime
Die UTC-Startzeit für den Empfang von Nachrichten.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiver zurück.
Ausnahmen
Wird ausgelöst, wenn für den Dienst ein vorübergehender Fehler auftritt.
Wird ausgelöst, wenn beim Client ein Problem beim Herstellen einer Verbindung mit dem Dienst auftritt.
Wird ausgelöst, wenn partitionId nicht innerhalb des erwarteten Bereichs liegt, der von der PartitionCount -Eigenschaft bestimmt wird.
Wird ausgelöst, wenn die Anzahl der Empfänger, die derzeit mit der angegebenen partitionId Partition verbunden sind, das vom Dienst festgelegte maximal zulässige Kontingent überschritten hat.
Wird ausgelöst, wenn derzeit ein Empfänger mit der Partition verbunden ist, wie von partitionIdangegeben, mit einer startingDateTimeUtc angegebenen.
Hinweise
Der Dienst verwendet dies startingDateTimeUtc nur als Näherung, wenn das nächste zu übermittelnde Ereignis bestimmt wird.
Beachten Sie, dass zwischen Clientzeit und Dienstzeit eine Abweichung der Uhr auftreten kann. Daher sollte die Benutzeranwendung so konzipiert werden, dass sie duplizierungen bei der Ereignisübermittlung verarbeitet.
Gilt für:
CreateReceiver(String, Int64, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition und den angegebenen Epochenwert. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- epoch
- Int64
Der Epochenwert. Der Dienst verwendet diesen Wert, um den Partitions-/Leasebesitz zu erzwingen.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiver zurück.
Ausnahmen
Wird ausgelöst, wenn für den Dienst ein vorübergehender Fehler auftritt.
Wird ausgelöst, wenn beim Client ein Problem beim Herstellen einer Verbindung mit dem Dienst auftritt.
Wird ausgelöst, wenn partitionId nicht innerhalb des erwarteten Bereichs liegt, der von der PartitionCount -Eigenschaft bestimmt wird.
Hinweise
Wenn der EventHubConsumerGroup Prüfpunkt aktiviert ist, erhält der Empfänger die nächste Nachricht vom Prüfpunktoffset. Wenn der Prüfpunkt deaktiviert ist, erhält der Empfänger eine Nachricht vom Anfang des Ereignisdatenstroms, wie durch die Nachrichtenaufbewahrungsrichtlinie des Event Hubs festgelegt.
Gilt für:
CreateReceiver(String, String, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingOffset
- String
Der Startoffset, ab dem mit dem Empfang von Nachrichten begonnen werden soll.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiver zurück.
Ausnahmen
Wird ausgelöst, wenn partitionId nicht innerhalb des erwarteten Bereichs liegt, der von der PartitionCount -Eigenschaft bestimmt wird.
Wird ausgelöst, wenn die Anzahl der Empfänger, die derzeit mit der angegebenen partitionId Partition verbunden sind, das vom Dienst festgelegte maximal zulässige Kontingent überschritten hat.
Wird ausgelöst, wenn derzeit ein Empfänger mit der Partition verbunden ist, wie von partitionIdangegeben, mit einer startingOffset angegebenen.
Gilt für:
CreateReceiver(String, EventPosition, Nullable<Int64>, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition an der angegebenen Startposition. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- position
- EventPosition
Die , EventPosition ab der nachrichten empfangen werden sollen.
Der Epochenwert. Wenn festgelegt, verwendet der Dienst diesen Wert, um den Partitions-/Leasebesitz zu erzwingen.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiverzurück.
Gilt für:
CreateReceiver(String, DateTime, Int64, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition, beginnend am angegebenen Datum und der angegebenen Uhrzeit.
Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingDateTimeUtc
- DateTime
Die UTC-Startzeit für den Empfang von Nachrichten.
- epoch
- Int64
Der Epochenwert. Der Dienst verwendet diesen Wert, um den Partitions-/Leasebesitz zu erzwingen.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiver zurück.
Ausnahmen
Wird ausgelöst, wenn für den Dienst ein vorübergehender Fehler auftritt.
Wird ausgelöst, wenn beim Client ein Problem beim Herstellen einer Verbindung mit dem Dienst auftritt.
Wird ausgelöst, wenn partitionId nicht innerhalb des erwarteten Bereichs liegt, der von der PartitionCount -Eigenschaft bestimmt wird.
Hinweise
Der Dienst verwendet dies startingDateTimeUtc nur als Näherung, wenn das nächste zu übermittelnde Ereignis bestimmt wird.
Beachten Sie, dass zwischen Clientzeit und Dienstzeit eine Abweichung der Uhr auftreten kann. Daher sollte die Benutzeranwendung so konzipiert werden, dass sie duplizierungen bei der Ereignisübermittlung verarbeitet.
Gilt für:
CreateReceiver(String, String, Boolean, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingOffset
- String
Der Startoffset, ab dem nachrichten empfangen werden sollen.
- offsetInclusive
- Boolean
Ein boolescher Wert, der angibt, ob startingOffset als inklusiver Offset behandelt wird, was bedeutet, dass die ersten Optionen für einen Event Hub-Empfänger. das zurückgegebene Ereignis ist das Ereignis, das den Startoffset enthält. Normalerweise ist das erste zurückgegebene Ereignis das Ereignis nach dem Startoffset.
- receiverOptions
- ReceiverOptions
Gibt zurück
Gibt EventHubReceiverzurück.
Gilt für:
CreateReceiver(String, String, Int64, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset.
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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingOffset
- String
Der Startoffset, ab dem nachrichten empfangen werden sollen. Informationen zum Angeben des Starts des Datenstroms finden Sie unter StartOfStream.
- epoch
- Int64
Der Epochenwert. Der Dienst verwendet diesen Wert, um den Partitions-/Leasebesitz zu erzwingen.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiver zurück.
Ausnahmen
Wird ausgelöst, wenn für den Dienst ein vorübergehender Fehler auftritt.
Wird ausgelöst, wenn beim Client ein Problem beim Herstellen einer Verbindung mit dem Dienst auftritt.
Wird ausgelöst, wenn partitionId sich nicht innerhalb des erwarteten Bereichs befindet, der von der PartitionCount -Eigenschaft bestimmt wird.
Gilt für:
CreateReceiver(String, String, Boolean, Int64, ReceiverOptions)
Erstellt einen neuen Event Hubs-Empfänger in der angegebenen Partition am angegebenen Startoffset. Sie können den erstellten Empfänger verwenden, um Ereignisse für eine Event Hubs-Partition zu empfangen, die durch angegeben wird 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 EventHubReceiverParameter
- partitionId
- String
Die ID der Partition.
- startingOffset
- String
Der Startoffset, ab dem nachrichten empfangen werden sollen.
- offsetInclusive
- Boolean
Ein boolescher Wert, der angibt, ob startingOffset als inklusiver Offset behandelt wird, was bedeutet, dass das erste zurückgegebene Ereignis das Ereignis ist, das den Startoffset enthält. Normalerweise ist das erste zurückgegebene Ereignis das Ereignis nach dem Startoffset.
- epoch
- Int64
Der Epochenwert. Der Dienst verwendet diesen Wert, um den Partitions-/Leasebesitz zu erzwingen.
- receiverOptions
- ReceiverOptions
Optionen für einen Event Hub-Empfänger.
Gibt zurück
Gibt EventHubReceiverzurück.
Gilt für:
Azure SDK for .NET