HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
応答置換ブロックを応答に挿入できます。これにより、出力キャッシュされた応答の指定された応答領域を動的に生成できます。
public:
void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)パラメーター
- callback
- HttpResponseSubstitutionCallback
置換するメソッド、ユーザー コントロール、またはオブジェクト。
例外
Control 型の callback パラメーターのターゲット。
注釈
メソッドを WriteSubstitution 使用して、出力キャッシュされたページでキャッシュ後の置換を行うことができます。 指定されたHttpResponseSubstitutionCallbackシグネチャをHttpContext使用してコールバック メソッドにオブジェクトを渡すことで、ページ キャッシュ内の任意の場所にあるキャッシュされた出力コンテンツを置き換えることができます。 置換を開始するには、 メソッドを WriteSubstitution 呼び出し、コールバック メソッドを渡します。これはスレッド セーフである必要があり、次のいずれかになります。
- コンテナー ページまたはユーザー コントロールの静的メソッド。
- 別の任意のオブジェクトの静的メソッドまたはインスタンス メソッド。
ページへの最初の要求で、 は WriteSubstitution デリゲートを HttpResponseSubstitutionCallback 呼び出して出力を生成します。 次に、応答に置換バッファーを追加します。これにより、今後の要求で呼び出すデリゲートが保持されます。 最後に、クライアント側のキャッシュ可能性がパブリックからサーバー専用に低下し、ページに対する今後の要求で、クライアントでキャッシュしないことによってデリゲートが再呼び出されるようにします。
注意
キャッシュ後の置換は、ユーザー コントロール レベルで出力キャッシュが適用されるキャッシュされたユーザー コントロールではサポートされていません。 これはフラグメント キャッシュとも呼ばれます。 詳細については、「 ASP.NET ページの一部をキャッシュする」を参照してください。
適用対象
こちらもご覧ください
.NET