EventHubProducerClient.CreateBatchAsync メソッド

定義

名前空間:

Azure.Messaging.EventHubs.Producer

アセンブリ:

Azure.Messaging.EventHubs.dll

パッケージ:

Azure.Messaging.EventHubs v5.11.3

オーバーロード

CreateBatchAsync(CancellationToken)	try ベースのパターンを使用して追加できるサイズ制約バッチ EventData を作成します。 イベントがバッチの最大許容サイズを超える場合、バッチはイベントの追加を許可せず、その戻り値を使用してそのシナリオを通知します。 サイズ制約に違反するイベントを追加できないため、イベントを Event Hubs サービスに送信しようとしたときに、バッチを発行しても例外はトリガーされません。
CreateBatchAsync(CreateBatchOptions, CancellationToken)	try ベースのパターンを使用して追加できるサイズ制約バッチ EventData を作成します。 イベントがバッチの最大許容サイズを超える場合、バッチはイベントの追加を許可せず、その戻り値を使用してそのシナリオを通知します。 サイズ制約に違反するイベントを追加できないため、イベントを Event Hubs サービスに送信しようとしたときに、バッチを発行しても例外はトリガーされません。

CreateBatchAsync(CancellationToken)

ソース:

EventHubProducerClient.cs

try ベースのパターンを使用して追加できるサイズ制約バッチ EventData を作成します。 イベントがバッチの最大許容サイズを超える場合、バッチはイベントの追加を許可せず、その戻り値を使用してそのシナリオを通知します。

サイズ制約に違反するイベントを追加できないため、イベントを Event Hubs サービスに送信しようとしたときに、バッチを発行しても例外はトリガーされません。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch> CreateBatchAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member CreateBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
override this.CreateBatchAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>

Public Overridable Function CreateBatchAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EventDataBatch)

パラメーター

cancellationToken

CancellationToken

操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。

戻り値

ValueTask<EventDataBatch>

EventDataBatch既定のバッチ オプションを持つ 。

こちらもご覧ください

• CreateBatchAsync(CreateBatchOptions, CancellationToken)
• SendAsync(EventDataBatch, CancellationToken)

CreateBatchAsync(CreateBatchOptions, CancellationToken)

ソース:

EventHubProducerClient.cs

try ベースのパターンを使用して追加できるサイズ制約バッチ EventData を作成します。 イベントがバッチの最大許容サイズを超える場合、バッチはイベントの追加を許可せず、その戻り値を使用してそのシナリオを通知します。

サイズ制約に違反するイベントを追加できないため、イベントを Event Hubs サービスに送信しようとしたときに、バッチを発行しても例外はトリガーされません。

public virtual System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch> CreateBatchAsync (Azure.Messaging.EventHubs.Producer.CreateBatchOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>
override this.CreateBatchAsync : Azure.Messaging.EventHubs.Producer.CreateBatchOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<Azure.Messaging.EventHubs.Producer.EventDataBatch>

Public Overridable Function CreateBatchAsync (options As CreateBatchOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of EventDataBatch)

パラメーター

options

CreateBatchOptions

このバッチを作成するときに考慮するオプションのセット。

cancellationToken

CancellationToken

操作を取り消す要求を通知する省略可能 CancellationToken な インスタンス。

戻り値

ValueTask<EventDataBatch>

EventDataBatch要求された optionsを持つ 。

例外

InvalidOperationException

でパーティション識別子とパーティション キーの両方が指定されている場合に発生します options。

こちらもご覧ください

• SendAsync(EventDataBatch, CancellationToken)
• CreateBatchAsync(CancellationToken)