共用方式為


HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) 方法

定義

允許回應替代區塊插入回應,以便為輸出快取的回應,動態產生指定的回應區域。

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

要替代的方法、使用者控制項或物件。

例外狀況

callback 參數之目標的型別為 Control

備註

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

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

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

注意

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

適用於

另請參閱