UserControl.CachePolicy Propriedade

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Obtém uma referência a uma coleção de parâmetros de cache para este controlo do utilizador.

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

Valor de Propriedade

ControlCachePolicy

A ControlCachePolicy contém propriedades que definem os parâmetros de cache para este UserControl.

Atributos
BrowsableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar a SupportsCaching propriedade para determinar se o controlo do utilizador pode ser armazenado em cache e, em caso afirmativo, definir a Duration propriedade para armazenar o controlo em cache durante 10 segundos.

<%@ 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>

Observações

A CachePolicy propriedade define os parâmetros de cache para a instância da UserControl classe. A CachePolicy propriedade é só de leitura; no entanto, pode definir as propriedades do ControlCachePolicy objeto que ela devolve.

A CachePolicy propriedade não pode ser definida declarativamente. Tem de ser definido programaticamente.

Aplica-se a

Ver também