Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

UserControl.CachePolicy-Eigenschaft

Aktualisiert: November 2007

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

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

[BrowsableAttribute(false)]
public ControlCachePolicy CachePolicy { get; }
/** @property */
/** @attribute BrowsableAttribute(false) */
public ControlCachePolicy get_CachePolicy()

public function get CachePolicy () : ControlCachePolicy

Eigenschaftenwert

Typ: System.Web.UI.ControlCachePolicy
Eine ControlCachePolicy, die Eigenschaften enthält, die die Zwischenspeicherungsparameter für dieses UserControl definieren.

Die CachePolicy-Eigenschaft definiert die Zwischenspeicherungsparameter für die Instanz der UserControl-Klasse. Die CachePolicy-Eigenschaft ist schreibgeschützt. Sie können aber die Eigenschaften des ControlCachePolicy-Objekts festlegen, das von der Eigenschaft zurückgegeben wird.

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

Im folgenden Codebeispiel wird veranschaulicht, wie mit der SupportsCaching-Eigenschaft bestimmt wird, ob das Benutzersteuerelement zwischengespeichert werden kann. Wenn dies der Fall ist, wird die Duration darauf festgelegt, das Steuerelement für 10 Sekunden zwischenzuspeichern.

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


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0
Anzeigen: