IReceiverClient.PrefetchCount プロパティ

定義

名前空間:

Microsoft.Azure.ServiceBus.Core

アセンブリ:

Microsoft.Azure.ServiceBus.dll

パッケージ:

Microsoft.Azure.ServiceBus v5.2.0

プリフェッチは、アプリケーションが Receive を使用してメッセージを要求する前に、ローカルの取得にメッセージをすぐに使用できるようにすることで、メッセージ フローを高速化します。 0 以外の値を設定すると、メッセージ数が PrefetchCount にプリフェッチされます。 値を 0 に設定すると、プリフェッチがオフになります。 既定値は 0 です。

public int PrefetchCount { get; set; }

member this.PrefetchCount : int with get, set

Public Property PrefetchCount As Integer

プロパティ値

Int32

注釈

プリフェッチが有効になっている場合、受信側は、アプリケーションがすぐに要求するメッセージよりも多くのメッセージ (PrefetchCount の制限まで) を静かに取得します。 したがって、1 回の最初の Receive/ReceiveAsync 呼び出しでは、すぐに返される即時消費のメッセージが取得され、クライアントはバックグラウンドでプリフェッチ バッファーを埋めるためにさらにメッセージを取得します。

メッセージはプリフェッチ バッファーで使用できますが、後続の ReceiveAsync 呼び出しはバッファーからすぐに満たされ、領域が使用可能になるとバックグラウンドでバッファーが補充されます。配信可能なメッセージがない場合、受信操作によってバッファーがドレインされ、期待どおりに待機またはブロックされます。

この値に更新は、サービスへの次回の受信呼び出しで有効になります。