UserControl.CachePolicy UserControl.CachePolicy UserControl.CachePolicy UserControl.CachePolicy Property

Определение

Возвращает ссылку на коллекцию параметров кэширования для данного пользовательского элемента управления.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; }
member this.CachePolicy : System.Web.UI.ControlCachePolicy
Public ReadOnly Property CachePolicy As ControlCachePolicy

Значение свойства

Значение ControlCachePolicy содержит свойства, определяющие параметры кэширования для UserControl.A ControlCachePolicy containing properties that define the caching parameters for this UserControl.

Примеры

В следующем примере кода показано, как использовать SupportsCaching свойство, чтобы определить, можно ли кэшировать пользовательский элемент управления, и, если это так, Duration устанавливает свойство для кэширования элемента управления в течение 10 секунд.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>

Комментарии

Свойство определяет параметры кэша для экземпляра UserControl класса. CachePolicyThe CachePolicy property defines the cache parameters for the instance of the UserControl class. Свойство доступно только для чтения, однако можно задать свойства ControlCachePolicy возвращаемого объекта. CachePolicyThe CachePolicy property is read-only; however, you can set the properties of the ControlCachePolicy object that it returns.

CachePolicy Свойство не может быть задано декларативно.The CachePolicy property cannot be set declaratively. Его необходимо задать программно.It must be set programmatically.

Применяется к

Дополнительно