HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) メソッド

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

応答置換ブロックを応答に挿入できます。これにより、出力キャッシュされた応答の指定された応答領域を動的に生成できます。

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);

public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);

member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit

Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

パラメーター

callback

HttpResponseSubstitutionCallback

置換するメソッド、ユーザー コントロール、またはオブジェクト。

例外

ArgumentException

Control 型の callback パラメーターのターゲット。

注釈

メソッドを WriteSubstitution 使用して、出力キャッシュされたページでキャッシュ後の置換を行うことができます。 指定されたHttpResponseSubstitutionCallbackシグネチャをHttpContext使用してコールバック メソッドにオブジェクトを渡すことで、ページ キャッシュ内の任意の場所にあるキャッシュされた出力コンテンツを置き換えることができます。 置換を開始するには、 メソッドを WriteSubstitution 呼び出し、コールバック メソッドを渡します。これはスレッド セーフである必要があり、次のいずれかになります。

• コンテナー ページまたはユーザー コントロールの静的メソッド。
• 別の任意のオブジェクトの静的メソッドまたはインスタンス メソッド。

ページへの最初の要求で、 は WriteSubstitution デリゲートを HttpResponseSubstitutionCallback 呼び出して出力を生成します。 次に、応答に置換バッファーを追加します。これにより、今後の要求で呼び出すデリゲートが保持されます。 最後に、クライアント側のキャッシュ可能性がパブリックからサーバー専用に低下し、ページに対する今後の要求で、クライアントでキャッシュしないことによってデリゲートが再呼び出されるようにします。

注意

キャッシュ後の置換は、ユーザー コントロール レベルで出力キャッシュが適用されるキャッシュされたユーザー コントロールではサポートされていません。 これはフラグメント キャッシュとも呼ばれます。 詳細については、「 ASP.NET ページの一部をキャッシュする」を参照してください。

こちらもご覧ください

• HttpResponseSubstitutionCallback
• Substitution
• ページのキャッシュ可能性の設定
• ASP.NET ページのキャッシュ部分
• キャッシュされたページの一部を動的に更新する