UserControl.CachePolicy 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取对该用户控件的缓存参数集合的引用。
public:
property System::Web::UI::ControlCachePolicy ^ CachePolicy { System::Web::UI::ControlCachePolicy ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Web.UI.ControlCachePolicy CachePolicy { get; }[<System.ComponentModel.Browsable(false)>]
member this.CachePolicy : System.Web.UI.ControlCachePolicyPublic ReadOnly Property CachePolicy As ControlCachePolicy属性值
一个 ControlCachePolicy，包含为该 UserControl 定义缓存参数的属性。
- 属性
示例
下面的代码示例演示如何使用 SupportsCaching 属性来确定是否可以缓存用户控件，如果是这样，则设置该 Duration 属性以缓存控件 10 秒。
<%@ page language="C#"%>
<%@ register src="SimpleControlcs.ascx"
tagname="SimpleControl"
tagprefix="uc1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Init(object sender, EventArgs e)
{
// If the control is already in the cache, calling properties
// will throw an exception. Make sure the control is available.
if (SimpleControl1 != null)
{
Page.DataBind();
if (SimpleControl1.CachePolicy.SupportsCaching)
{
// Set the cache duration to 10 seconds.
SimpleControl1.CachePolicy.Duration = new TimeSpan(0, 0, 10);
}
}
}
</script>
<%@ page language="VB"%>
<%@ register src="SimpleControlvb.ascx"
tagname="SimpleControl"
tagprefix="uc1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
If SimpleControl1 IsNot Nothing Then
Page.DataBind()
If SimpleControl1.CachePolicy.SupportsCaching Then
' Set the cache duration to 10 seconds.
SimpleControl1.CachePolicy.Duration = New TimeSpan(0, 0, 10)
End If
End If
End Sub
</script>
注解
该 CachePolicy 属性定义类实例的 UserControl 缓存参数。 该 CachePolicy 属性是只读的;但是，可以设置它返回的对象的属性 ControlCachePolicy 。
无法 CachePolicy 以声明方式设置该属性。 必须以编程方式设置它。