次の方法で共有


IReceiverClient.PrefetchCount プロパティ

定義

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

public int PrefetchCount { get; set; }
member this.PrefetchCount : int with get, set
Public Property PrefetchCount As Integer

プロパティ値

注釈

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

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

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

適用対象