/// <summary> /// Creates an event receiver responsible for reading <see cref="EventData" /> from a specific Event Hub partition, /// and as a member of a specific consumer group. /// /// A receiver may be exclusive, which asserts ownership over the partition for the consumer /// group to ensure that only one receiver from that group is reading the from the partition. /// These exclusive receivers are sometimes referred to as "Epoch Receivers." /// /// A receiver may also be non-exclusive, allowing multiple receivers from the same consumer /// group to be actively reading events from the partition. These non-exclusive receivers are /// sometimes referred to as "Non-epoch Receivers." /// /// Designating a receiver as exclusive may be specified in the <paramref name="receiverOptions" />. /// By default, receivers are created as non-exclusive. /// </summary> /// /// <param name="partitionId">The identifier of the Event Hub partition from which events will be received.</param> /// <param name="receiverOptions">The set of options to apply when creating the receiver.</param> /// /// <returns>An event receiver configured in the requested manner.</returns> /// /// <remarks> /// If the starting event position is not specified in the <paramref name="receiverOptions"/>, the receiver will /// default to ignoring events in the partition that were queued prior to the receiver being created and read only /// events which appear after that point. /// </remarks> /// public virtual EventReceiver CreateReceiver(string partitionId, EventReceiverOptions receiverOptions = default) { Guard.ArgumentNotNullOrEmpty(nameof(partitionId), partitionId); var options = receiverOptions?.Clone() ?? new EventReceiverOptions { Retry = null, DefaultMaximumReceiveWaitTime = null }; options.Retry = options.Retry ?? ClientOptions.Retry.Clone(); options.DefaultMaximumReceiveWaitTime = options.MaximumReceiveWaitTimeOrDefault ?? ClientOptions.DefaultTimeout; return(InnerClient.CreateReceiver(partitionId, options)); }