UserControl.CachePolicy Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a reference to a collection of caching parameters for this user control.
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.ControlCachePolicy
Public ReadOnly Property CachePolicy As ControlCachePolicy
Property Value
A ControlCachePolicy containing properties that define the caching parameters for this UserControl.
- Attributes
Examples
The following code example demonstrates how to use the SupportsCaching property to determine whether the user control can be cached, and if so, sets the Duration property to cache the control for 10 seconds.
<%@ 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>
Remarks
The CachePolicy property defines the cache parameters for the instance of the UserControl class. The CachePolicy property is read-only; however, you can set the properties of the ControlCachePolicy object that it returns.
The CachePolicy property cannot be set declaratively. It must be set programmatically.
Applies to
See also
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應