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

callback 參數之目標的型別為 Control。

備註

您可以在 WriteSubstitution 輸出快取的頁面中使用 方法進行快取後替代。 藉由使用指定的HttpResponseSubstitutionCallback簽章將 對象傳遞HttpContext至回呼方法，即可取代頁面快取中任何指定位置的輸出快取內容。 若要起始取代，請呼叫 WriteSubstitution 方法，並傳遞回呼方法，這必須是安全線程，而且可以是下列其中一項：

• 容器頁面或使用者控件上的靜態方法。
• 另一個任意物件上的靜態或實例方法。

在第一次要求頁面上，呼叫 WriteSubstitutionHttpResponseSubstitutionCallback 委派以產生輸出。 然後，它會將替代緩衝區新增至回應，以保留委派來呼叫未來要求。 最後，它會將用戶端的快取性從公用降級為僅限伺服器，確保未來對頁面的要求不會在用戶端上快取來重新叫用委派。

注意

快取后替代不支援快取的使用者控件，其中輸出快取會在使用者控制層級套用。 這也稱為片段快取。 如需詳細資訊，請參閱 快取 ASP.NET 頁面的部分。

另請參閱

• HttpResponseSubstitutionCallback
• Substitution
• 設定頁面的快取性
• 快取 ASP.NET 頁面的部分
• 動態更新快取頁面的部分