UserControl.CachePolicy Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает ссылку на коллекцию параметров кэширования для данного пользовательского элемента управления.
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 нельзя задать декларативно. Его необходимо задать программным способом.