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 标记的控件 ID。 (继承自 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 |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 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 |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 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) |
方法
事件
| 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) |
返回包含数据控件的元表对象。 |
