Substitution 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定輸出快取網頁上不需要快取的區段。 在這個位置，擷取和替代 Substitution 控制項的動態內容。
public ref class Substitution : System::Web::UI::Controlpublic class Substitution : System.Web.UI.Controltype Substitution = class
inherit ControlPublic Class Substitution
Inherits Control- 繼承
範例
下列程式碼範例示範如何以宣告方式將 Substitution 控制項新增至輸出快取的網頁。 當頁面載入時，目前的日期和時間會顯示給標籤中的使用者。 頁面的這個區段只會快取並每 60 秒更新一次。 當 Substitution 控制項執行時，它會呼叫 GetCurrentDateTime 方法。 所 GetCurrentDateTime 傳回的字串會顯示給使用者。 頁面的這個區段不會快取，而且會在每次重新整理頁面時更新。
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">
void Page_Load(object sender, System.EventArgs e)
{
// Display the current date and time in the label.
// Output caching applies to this section of the page.
CachedDateLabel.Text = DateTime.Now.ToString();
}
// The Substitution control calls this method to retrieve
// the current date and time. This section of the page
// is exempt from output caching.
public static string GetCurrentDateTime (HttpContext context)
{
return DateTime.Now.ToString ();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Substitution Class Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Substitution Class Example</h3>
<p>This section of the page is not cached:</p>
<asp:substitution id="Substitution1"
methodname="GetCurrentDateTime"
runat="Server">
</asp:substitution>
<br />
<p>This section of the page is cached:</p>
<asp:label id="CachedDateLabel"
runat="Server">
</asp:label>
<br /><br />
<asp:button id="RefreshButton"
text="Refresh Page"
runat="Server">
</asp:button>
</form>
</body>
</html>
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="VB">
Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
' Display the current date and time in the label.
' Output caching applies to this section of the page.
CachedDateLabel.Text = DateTime.Now.ToString()
End Sub
' The Substitution control calls this method to retrieve
' the current date and time. This section of the page
' is exempt from output caching.
Shared Function GetCurrentDateTime(ByVal context As HttpContext) As String
Return DateTime.Now.ToString()
End Function
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Substitution Class Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Substitution Class Example</h3>
<p>This section of the page is not cached:</p>
<asp:substitution id="Substitution1"
methodname="GetCurrentDateTime"
runat="Server">
</asp:substitution>
<br />
<p>This section of the page is cached:</p>
<asp:label id="CachedDateLabel"
runat="Server">
</asp:label>
<br /><br />
<asp:button id="RefreshButton"
text="Refresh Page"
runat="Server">
</asp:button>
</form>
</body>
</html>
備註
本主題內容：
簡介
使用 Substitution 控制項來指定輸出快取網頁上的區段，而您想要動態內容取代控制項。 控制項 Substitution 會針對大部分內容快取的頁面，提供簡化的解決方案給部分頁面快取。 您可以輸出快取整個頁面，然後使用 Substitution 控制項來指定免快取的頁面部分。 快取區域只會執行一次，並從快取重新執行，直到快取專案到期或清除為止。 每次要求頁面時，都會執行動態區域。 此快取模型可簡化主要靜態頁面的程式碼，因為您不需要封裝區段，即可在 Web 使用者控制項中快取。 例如，此快取模型適用于您有包含靜態內容的頁面，例如新聞劇本，以及 AdRotator 顯示廣告的控制項。 新聞報導不會變更，這表示可以快取。 不過，每當使用者要求頁面時，您會想要顯示新的廣告。 控制項 AdRotator 直接支援快取後替代，並在每次頁面回傳時轉譯新的公告，而不論是否快取頁面。
注意
您可以將控制項放在 Substitution 包含在快取頁面中的使用者控制項中。 不過，您無法將 Substitution 控制項放在輸出快取的使用者控制項中。
當 Substitution 控制項執行時，它會呼叫傳回字串的方法。 方法傳回的字串是要顯示在控制項位置 Substitution 頁面上的內容。 MethodName使用 屬性可指定要在控制項執行時 Substitution 叫用的回呼方法名稱。 您指定的回呼方法必須是頁面或包含 Substitution 控制項的使用者控制項上的靜態方法。 回呼方法的簽章必須符合接受 HttpContext 參數並傳回字串之委派的簽 HttpResponseSubstitutionCallback 章。
若要動作頁面的輸出快取，您可以使用 @ OutputCache 指示詞、 HttpCachePolicy 類別或 Cache 屬性。 如需快取頁面的詳細資訊，請參閱快取 ASP.NET 網頁 和 快取 ASP.NET 網頁的部分。
除了使用 Substitution 控制項，您也可以使用 HttpResponseSubstitutionCallback 委派取得替代快取行為。 此外，您可以在直接支援此功能的 AdRotator 控制項上取得替代快取行為，例如控制項。 如需詳細資訊，請參閱 動態更新快取頁面的部分。
宣告式語法
<asp:Substitution
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
MethodName="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Visible="True|False"
/>
建構函式
| Substitution() |
初始化 Substitution 類別的新執行個體。 |
屬性
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
| ChildControlsCreated |
取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
| ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DesignMode |
取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control) |
| EnableTheming |
取得或設定值，指出佈景主題是否套用至此控制項。 (繼承來源 Control) |
| EnableViewState |
取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control) |
| Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| HasChildViewState |
取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
| ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
| IsChildControlStateCleared |
取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
| IsTrackingViewState |
取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
| MethodName |
取得或設定 Substitution 控制項執行時要叫用的回呼方法名稱。 |
| NamingContainer |
取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
| Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
| Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
| RenderingCompatibility |
取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
| Site |
當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
| SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 Control) |
| TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
方法
| AddedControl(Control, Int32) |
在子控制項加入 Control 物件的 Controls 集合後呼叫。 (繼承來源 Control) |
| AddParsedSubObject(Object) |
通知伺服器控制項，XML 或 HTML 項目已剖析，並將項目加入伺服器控制項的 ControlCollection 物件中。 (繼承來源 Control) |
| ApplyStyleSheetSkin(Page) |
將頁面樣式表中所定義的樣式屬性套用至控制項。 (繼承來源 Control) |
| BeginRenderTracing(TextWriter, Object) |
開始進行轉譯資料的設計階段追蹤。 (繼承來源 Control) |
| BuildProfileTree(String, Boolean) |
收集伺服器控制項的相關資訊，並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。 (繼承來源 Control) |
| ClearCachedClientID() |
將快取的 ClientID 值設定為 |
| ClearChildControlState() |
刪除伺服器控制項之子控制項的控制項狀態資訊。 (繼承來源 Control) |
| ClearChildState() |
刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。 (繼承來源 Control) |
| ClearChildViewState() |
刪除所有伺服器控制項之子控制項的檢視狀態資訊。 (繼承來源 Control) |
| ClearEffectiveClientIDMode() |
將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit。 (繼承來源 Control) |
| CreateChildControls() |
由 ASP.NET 網頁架構呼叫，通知使用組合實作的伺服器控制項來建立所包含的任何子控制項，以準備回傳或呈現。 (繼承來源 Control) |
| CreateControlCollection() |
傳回 EmptyControlCollection 物件，表示 Substitution 控制項不支援子控制項。 |
| DataBind() |
將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。 (繼承來源 Control) |
| DataBind(Boolean) |
使用會引發 DataBinding 事件的選項，繫結資料來源至叫用的伺服器控制項及其所有子控制項。 (繼承來源 Control) |
| DataBindChildren() |
繫結資料來源至伺服器控制項的子控制項。 (繼承來源 Control) |
| Dispose() |
啟用伺服器控制項，在它從記憶體釋放之前執行最後清除。 (繼承來源 Control) |
| EndRenderTracing(TextWriter, Object) |
結束轉譯資料的設計階段追蹤。 (繼承來源 Control) |
| EnsureChildControls() |
判斷伺服器控制項是否包含子控制項。 如果不包含，則建立子控制項。 (繼承來源 Control) |
| EnsureID() |
為尚未指定識別項的控制項，建立識別項。 (繼承來源 Control) |
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| FindControl(String) |
在目前命名容器搜尋具有指定 |
| FindControl(String, Int32) |
使用指定的 |
| Focus() |
設定控制項的輸入焦點。 (繼承來源 Control) |
| GetDesignModeState() |
取得控制項的設計階段資料。 (繼承來源 Control) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetRouteUrl(Object) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
| GetRouteUrl(RouteValueDictionary) |
取得會對應於一組路由參數的 URL。 (繼承來源 Control) |
| GetRouteUrl(String, Object) |
取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
| GetRouteUrl(String, RouteValueDictionary) |
取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control) |
| GetType() |
取得目前執行個體的 Type。 (繼承來源 Object) |
| GetUniqueIDRelativeTo(Control) |
傳回指定之控制項 UniqueID 屬性的前置部分。 (繼承來源 Control) |
| HasControls() |
判斷伺服器控制項是否包含任何子控制項。 (繼承來源 Control) |
| HasEvents() |
傳回值，指出控制項或任何子控制項的事件是否已註冊。 (繼承來源 Control) |
| IsLiteralContent() |
判斷伺服器控制項是否只儲存常值內容。 (繼承來源 Control) |
| LoadControlState(Object) |
從 SaveControlState() 方法所儲存的上一頁要求中，還原控制項狀態資訊。 (繼承來源 Control) |
| LoadViewState(Object) |
從 SaveViewState() 方法所儲存的先前頁面要求來還原檢視狀態資訊。 (繼承來源 Control) |
| MapPathSecure(String) |
擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。 (繼承來源 Control) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| OnBubbleEvent(Object, EventArgs) |
決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。 (繼承來源 Control) |
| OnDataBinding(EventArgs) |
引發 DataBinding 事件。 (繼承來源 Control) |
| OnInit(EventArgs) |
引發 Init 事件。 (繼承來源 Control) |
| OnLoad(EventArgs) |
引發 Load 事件。 (繼承來源 Control) |
| OnPreRender(EventArgs) |
引發 PreRender 事件。 |
| OnUnload(EventArgs) |
引發 Unload 事件。 (繼承來源 Control) |
| OpenFile(String) |
取得用來讀取檔案的 Stream。 (繼承來源 Control) |
| RaiseBubbleEvent(Object, EventArgs) |
指派事件的任何來源和它的資訊至控制項的父控制項。 (繼承來源 Control) |
| RemovedControl(Control) |
從 Control 物件的 Controls 集合中移除子控制項之後呼叫。 (繼承來源 Control) |
| Render(HtmlTextWriter) |
將伺服器控制項內容傳送到提供的 HtmlTextWriter 物件，以寫入要在用戶端上呈現的內容。 |
| RenderChildren(HtmlTextWriter) |
將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件，再由這個物件在用戶端上寫入要轉譯的內容。 (繼承來源 Control) |
| RenderControl(HtmlTextWriter) |
將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件，並在啟用追蹤時儲存控制項的追蹤資訊。 (繼承來源 Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
使用提供的 HtmlTextWriter 物件，輸出伺服器控制項內容至提供的 ControlAdapter 物件。 (繼承來源 Control) |
| ResolveAdapter() |
取得負責呈現指定之控制項的控制項配置器。 (繼承來源 Control) |
| ResolveClientUrl(String) |
取得瀏覽器可使用的 URL。 (繼承來源 Control) |
| ResolveUrl(String) |
將 URL 轉換為要求用戶端可使用的 URL。 (繼承來源 Control) |
| SaveControlState() |
儲存頁面回傳至伺服器以來，所發生的任何伺服器控制項狀態變更。 (繼承來源 Control) |
| SaveViewState() |
儲存自頁面回傳至伺服器以來所發生的任何伺服器控制項檢視狀態變更。 (繼承來源 Control) |
| SetDesignModeState(IDictionary) |
設定控制項的設計階段資料。 (繼承來源 Control) |
| SetRenderMethodDelegate(RenderMethod) |
指定事件處理常式委派，以呈現伺服器控制項及其內容至其父控制項。 (繼承來源 Control) |
| SetTraceData(Object, Object) |
使用追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
| SetTraceData(Object, Object, Object) |
使用追蹤的物體、追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control) |
| ToString() |
傳回代表目前物件的字串。 (繼承來源 Object) |
| TrackViewState() |
導致對伺服器控制項的檢視狀態變更的追蹤 (Tracking)，以便它們能夠儲存於伺服器控制項的 StateBag 物件。 這個物件可透過 ViewState 屬性存取。 (繼承來源 Control) |
事件
| DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
| Disposed |
發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
| Init |
發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
| PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
| Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
| IControlBuilderAccessor.ControlBuilder |
如需這個成員的說明，請參閱 ControlBuilder。 (繼承來源 Control) |
| IControlDesignerAccessor.GetDesignModeState() |
如需這個成員的說明，請參閱 GetDesignModeState()。 (繼承來源 Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
如需這個成員的說明，請參閱 SetDesignModeState(IDictionary)。 (繼承來源 Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
如需這個成員的說明，請參閱 SetOwnerControl(Control)。 (繼承來源 Control) |
| IControlDesignerAccessor.UserData |
如需這個成員的說明，請參閱 UserData。 (繼承來源 Control) |
| IDataBindingsAccessor.DataBindings |
如需這個成員的說明，請參閱 DataBindings。 (繼承來源 Control) |
| IDataBindingsAccessor.HasDataBindings |
如需這個成員的說明，請參閱 HasDataBindings。 (繼承來源 Control) |
| IExpressionsAccessor.Expressions |
如需這個成員的說明，請參閱 Expressions。 (繼承來源 Control) |
| IExpressionsAccessor.HasExpressions |
如需這個成員的說明，請參閱 HasExpressions。 (繼承來源 Control) |
| IParserAccessor.AddParsedSubObject(Object) |
如需這個成員的說明，請參閱 AddParsedSubObject(Object)。 (繼承來源 Control) |
擴充方法
| FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
| FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應