UserControl.CachePolicy Właściwość

Definicja

Pobiera odwołanie do kolekcji parametrów buforowania dla tej kontrolki użytkownika.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

Wartość właściwości

ControlCachePolicy

ControlCachePolicyZawierające właściwości, które definiują parametry buforowania dla tego elementu UserControl .A ControlCachePolicy containing properties that define the caching parameters for this UserControl.

Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak użyć SupportsCaching właściwości, aby określić, czy kontrolka użytkownika może być buforowana, a jeśli tak, ustawia Duration Właściwość w celu buforowania kontrolki przez 10 sekund.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>

Uwagi

CachePolicyWłaściwość definiuje parametry pamięci podręcznej dla wystąpienia UserControl klasy.The CachePolicy property defines the cache parameters for the instance of the UserControl class. CachePolicyWłaściwość jest tylko do odczytu, ale można ustawić właściwości ControlCachePolicy zwracanego obiektu.The CachePolicy property is read-only; however, you can set the properties of the ControlCachePolicy object that it returns.

CachePolicyNie można deklaratywnie ustawić właściwości.The CachePolicy property cannot be set declaratively. Musi być ustawiona programowo.It must be set programmatically.

Dotyczy

Zobacz też