Freigeben über


PartialCachingAttribute Konstruktoren

Definition

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse.

Überlädt

PartialCachingAttribute(Int32)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse mit der angegebenen Dauer, die dem Benutzersteuerelement zugewiesen ist, das zwischengespeichert werden soll.

PartialCachingAttribute(Int32, String, String, String)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches angibt.

PartialCachingAttribute(Int32, String, String, String, Boolean)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.

PartialCachingAttribute(Int32, String, String, String, String, Boolean)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen, benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches und Datenbankabhängigkeiten sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.

PartialCachingAttribute(Int32)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse mit der angegebenen Dauer, die dem Benutzersteuerelement zugewiesen ist, das zwischengespeichert werden soll.

public:
 PartialCachingAttribute(int duration);
public PartialCachingAttribute (int duration);
new System.Web.UI.PartialCachingAttribute : int -> System.Web.UI.PartialCachingAttribute
Public Sub New (duration As Integer)

Parameter

duration
Int32

Die Zeitspanne in Sekunden, über die ein Benutzersteuerelement im Ausgabecache zwischengespeichert werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der PartialCachingAttribute(Int32) Konstruktor auf ein Benutzersteuerelement angewendet werden kann. Im Beispiel wird der Konstruktor verwendet, um anzugeben, dass das Benutzersteuerelement zwischengespeichert werden kann und um die Zwischenspeicherdauer anzugeben. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die PartialCachingAttribute-Klasse bereitgestellt wird.

// Set the PartialCachingAttribute.Duration property to 20 seconds.
[PartialCaching(20)]
public partial class ctlMine : UserControl
' Set the PartialCachingAttribute.Duration property to 20 seconds.
<PartialCaching(20)> _
Partial Class ctlMine
    Inherits UserControl

Gilt für

PartialCachingAttribute(Int32, String, String, String)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches angibt.

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom);
public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom);
new System.Web.UI.PartialCachingAttribute : int * string * string * string -> System.Web.UI.PartialCachingAttribute
Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String)

Parameter

duration
Int32

Die Zeitspanne in Sekunden, über die das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. In der Standardeinstellung entsprechen diese Zeichenfolgen dem Wert einer Abfragezeichenfolge, die mit GET-Methodenattributen gesendet wurde, oder einem Parameter, der mit der POST-Methode gesendet wurde. Wenn dieses Attribut auf mehrere Parameter festgelegt wird, enthält der Ausgabecache für jeden angegeben Parameter eine andere Version des angeforderten Dokuments. Mögliche Werte sind "none", "*" sowie alle gültigen Abfragezeichenfolgen oder POST-Parameternamen.

varyByControls
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. Diese Zeichenfolgen stellen voll gekennzeichnete Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, wird die Ausgabe des Benutzersteuerelements mit dem Cache aller angegeben Eigenschaften des Benutzersteuerelements geändert.

varyByCustom
String

Beliebiger Text, der benutzerdefinierte Anforderungen für Ausgabecaches darstellt. Wenn diesem Parameter der Wert "browser" zugewiesen wird, variiert der Cache je nach Browsernamen und Hauptversionsinformationen. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die GetVaryByCustomString(HttpContext, String)-Methode in der Datei Global.asax der Anwendung überschreiben.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der PartialCachingAttribute(Int32, String, String, String) Konstruktor auf ein Benutzersteuerelement angewendet werden kann. Im Beispiel wird der Konstruktor verwendet, um anzugeben, dass das Benutzersteuerelement zwischengespeichert werden kann, die Zwischenspeicherdauer als 20 Sekunden angeben und ein Steuerelement angeben, das benannt state ist, für das die Benutzersteuerelementausgabe unterschiedlich sein wird.

// Set the PartialCachingAttribute.Duration property to
// 20 seconds and the PartialCachingAttribute.VaryByControls
// property to the ID of the server control to vary the output by.
// In this case, it is state, the ID assigned to a DropDownList
// server control.
[PartialCaching(20, null, "state", null)]
' Set the PartialCachingAttribute.Duration property to
' 20 seconds and the PartialCachingAttribute.VaryByControls
' property to the ID of the server control to vary the output by.
' In this case, it is state, the ID assigned to a DropDownList
' server control.
<PartialCaching(20, Nothing, "state", Nothing)> _
Public Class ctlSelect
    Inherits UserControl

Gilt für

PartialCachingAttribute(Int32, String, String, String, Boolean)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, bool shared);
public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, bool shared);
new System.Web.UI.PartialCachingAttribute : int * string * string * string * bool -> System.Web.UI.PartialCachingAttribute
Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, shared As Boolean)

Parameter

duration
Int32

Die Zeitspanne in Sekunden, über die das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. In der Standardeinstellung entsprechen diese Zeichenfolgen dem Wert einer Abfragezeichenfolge, die mit GET-Methodenattributen gesendet wurde, oder einem Parameter, der mit der POST-Methode gesendet wurde. Wenn dieses Attribut auf mehrere Parameter festgelegt wird, enthält der Ausgabecache für jeden angegeben Parameter eine andere Version des angeforderten Dokuments. Mögliche Werte sind "none", "*" sowie alle gültigen Abfragezeichenfolgen oder POST-Parameternamen.

varyByControls
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. Diese Zeichenfolgen stellen voll gekennzeichnete Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, wird die Ausgabe des Benutzersteuerelements mit dem Cache aller angegeben Eigenschaften des Benutzersteuerelements geändert.

varyByCustom
String

Beliebiger Text, der benutzerdefinierte Anforderungen für Ausgabecaches darstellt. Wenn diesem Parameter der Wert "browser" zugewiesen wird, variiert der Cache je nach Browsernamen und Hauptversionsinformationen. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die GetVaryByCustomString(HttpContext, String)-Methode in der Datei Global.asax der Anwendung überschreiben.

shared
Boolean

true, wenn Ausgaben von Benutzersteuerelementen von mehreren Seiten gemeinsam verwendet werden können, andernfalls false.

Gilt für

PartialCachingAttribute(Int32, String, String, String, String, Boolean)

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen, benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches und Datenbankabhängigkeiten sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, System::String ^ sqlDependency, bool shared);
public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, string sqlDependency, bool shared);
new System.Web.UI.PartialCachingAttribute : int * string * string * string * string * bool -> System.Web.UI.PartialCachingAttribute
Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, sqlDependency As String, shared As Boolean)

Parameter

duration
Int32

Die Zeitspanne in Sekunden, über die das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. In der Standardeinstellung entsprechen diese Zeichenfolgen dem Wert einer Abfragezeichenfolge, die mit GET-Methodenattributen gesendet wurde, oder einem Parameter, der mit der POST-Methode gesendet wurde. Wenn dieses Attribut auf mehrere Parameter festgelegt wird, enthält der Ausgabecache für jeden angegeben Parameter eine andere Version des angeforderten Dokuments. Mögliche Werte sind "none", "*" sowie alle gültigen Abfragezeichenfolgen oder POST-Parameternamen.

varyByControls
String

Eine durch Semikolon getrennte Liste von Zeichenfolgen, die zum Ändern des Ausgabecaches verwendet wird. Diese Zeichenfolgen stellen voll gekennzeichnete Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, wird die Ausgabe des Benutzersteuerelements mit dem Cache aller angegeben Eigenschaften des Benutzersteuerelements geändert.

varyByCustom
String

Beliebiger Text, der benutzerdefinierte Anforderungen für Ausgabecaches darstellt. Wenn diesem Parameter der Wert "browser" zugewiesen wird, variiert der Cache je nach Browsernamen und Hauptversionsinformationen. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die GetVaryByCustomString(HttpContext, String)-Methode in der Datei Global.asax der Anwendung überschreiben.

sqlDependency
String

Eine durch Trennzeichen getrennte Liste von Datenbanknamen und Tabellennamen, bei deren Änderung ein Cacheeintrag im ASP.NET-Cache ausdrücklich abläuft. Diese Datenbanknamen entsprechen den SQL Server-Cacheabhängigkeiten, die im Webkonfigurationsabschnitt angegeben sind.

shared
Boolean

true, wenn Ausgaben von Benutzersteuerelementen von mehreren Seiten gemeinsam verwendet werden können, andernfalls false.

Gilt für