UserControl.CachePolicy Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Verweis auf eine Auflistung von Zwischenspeicherungsparametern für dieses Benutzersteuerelement ab.

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

Eigenschaftswert

ControlCachePolicy

Eine ControlCachePolicy, die Eigenschaften enthält, die die Zwischenspeicherungsparameter für dieses UserControl definieren.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SupportsCaching -Eigenschaft verwendet wird, um zu bestimmen, ob das Benutzersteuerelement zwischengespeichert werden kann. Wenn ja, legt die Eigenschaft fest Duration , dass das Steuerelement 10 Sekunden lang zwischengespeichert wird.

ASP.NET (C#)

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

Hinweise

Die CachePolicy -Eigenschaft definiert die Cacheparameter für die Instanz der UserControl -Klasse. Die CachePolicy Eigenschaft ist schreibgeschützt; Sie können jedoch festlegen, die Eigenschaften der ControlCachePolicy -Objekt, das zurückgegeben.

Die CachePolicy Eigenschaft kann nicht deklarativ festgelegt werden. Sie muss programmgesteuert festgelegt werden.

Gilt für:

Produkt	Versionen
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Teilen über