HttpResponse.WriteSubstitution メソッド

.NET Framework クラス ライブラリ リファレンス

HttpResponse.WriteSubstitution メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub WriteSubstitution ( _
    callback As HttpResponseSubstitutionCallback _
)

Visual Basic (使用法)

Dim instance As HttpResponse
Dim callback As HttpResponseSubstitutionCallback

instance.WriteSubstitution(callback)

C#

public void WriteSubstitution (
    HttpResponseSubstitutionCallback callback
)

C++

public:
void WriteSubstitution (
    HttpResponseSubstitutionCallback^ callback
)

J#

public void WriteSubstitution (
    HttpResponseSubstitutionCallback callback
)

JScript

public function WriteSubstitution (
    callback : HttpResponseSubstitutionCallback
)

パラメータ

callback

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

解説

WriteSubstitution メソッドを使用して、出力キャッシュされたページでキャッシュ後置換を実行できます。HttpContext オブジェクトを所定の HttpResponseSubstitutionCallback シグネチャを使用するコールバック メソッドに渡すことで、出力キャッシュされたコンテンツをページ キャッシュでの位置に関係なく置換できます。置換を実行するには、WriteSubstitution メソッドを呼び出し、それをコールバック メソッドに渡します。コールバック メソッドは、スレッド セーフであり、かつ次のどちらであることが必要です。

• 格納ページまたはユーザー コントロールの静的メソッド。

• 任意の別のオブジェクトの静的メソッドまたはインスタンス メソッド。

ページに対する最初の要求で、WriteSubstitution は HttpResponseSubstitutionCallback デリゲートを呼び出して、出力を生成します。次に、応答に置換バッファを追加し、そこにその後の要求で呼び出すデリゲートを保持します。最後に、クライアント側のキャッシュの設定をパブリックからサーバーのみへデリゲートし、その後そのページが要求された場合に、クライアントでキャッシュすることなくデリゲートを再呼び出しできるようにします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpResponse クラス
HttpResponse メンバ
System.Web 名前空間
HttpResponseSubstitutionCallback
Substitution
その他の技術情報
ページのキャッシュの設定
ASP.NET ページの一部だけのキャッシュ
キャッシュ ページの動的な部分更新