Share via


EventHubClient.CreateEpochReceiver Methode

Definition

Erstellen Sie einen Epoch-basierten EventHub-Empfänger mit dem angegebenen EventPosition. Der Empfänger wird für eine bestimmte EventHub-Partition aus der jeweiligen Consumergruppe erstellt.

Es ist wichtig, bei der Erstellung von epochenbasierten Empfängern auf Folgendes zu achten:

- Besitzerzwingung: Nachdem Sie einen epochenbasierten Empfänger erstellt haben, können Sie keinen Nicht-Epochen-Empfänger für dieselbe consumerGroup-Partition-Kombination erstellen, bis alle Empfänger für die Kombination geschlossen sind.

- Besitzdiebstahl: Wenn ein Empfänger mit einem höheren Epochenwert für eine consumerGroup-Partition-Kombination erstellt wird, wird jeder ältere Epochenempfänger für diese Kombination erzwungen.

- Jeder Empfänger, der aufgrund eines Verlusts des Besitzes an eine consumerGroup-Partition-Kombination geschlossen wird, erhält ReceiverDisconnectedException für alle Vorgänge dieses Empfängers.
public Microsoft.Azure.EventHubs.PartitionReceiver CreateEpochReceiver (string consumerGroupName, string partitionId, Microsoft.Azure.EventHubs.EventPosition eventPosition, long epoch, Microsoft.Azure.EventHubs.ReceiverOptions receiverOptions = default);
member this.CreateEpochReceiver : string * string * Microsoft.Azure.EventHubs.EventPosition * int64 * Microsoft.Azure.EventHubs.ReceiverOptions -> Microsoft.Azure.EventHubs.PartitionReceiver
Public Function CreateEpochReceiver (consumerGroupName As String, partitionId As String, eventPosition As EventPosition, epoch As Long, Optional receiverOptions As ReceiverOptions = Nothing) As PartitionReceiver

Parameter

consumerGroupName
String

der Name der Consumergruppe, unter der dieser Empfänger gruppiert werden soll.

partitionId
String

die Partitions-ID, zu der der Empfänger gehört. Alle empfangenen Daten stammen nur von dieser Partition.

eventPosition
EventPosition

Die , EventPosition ab der nachrichten empfangen werden sollen.

epoch
Int64

ein eindeutiger Bezeichner (Epochenwert), den der Dienst verwendet, um den Partitions-/Leasebesitz zu erzwingen.

receiverOptions
ReceiverOptions

Optionen für einen Event Hub-Empfänger.

Gibt zurück

Der erstellte PartitionReceiver

Gilt für:

Weitere Informationen