PartialCachingAttribute Konstruktoren

Definition

Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse.

Überlädt

Name Beschreibung
PartialCachingAttribute(Int32)

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse mit der angegebenen Dauer, die dem Benutzersteuerelement zugewiesen ist, um zwischengespeichert zu werden.

PartialCachingAttribute(Int32, String, String, String)

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse, wobei die Zwischenspeicherdauer, alle GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung angegeben werden, die zum Variieren des Caches verwendet werden.

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

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse, wobei die Zwischenspeicherdauer, alle GET Werte POST , Steuerelementnamen, benutzerdefinierte Zwischenspeicherungsanforderungen, die verwendet werden, um den Cache zu variieren, und ob die Benutzersteuerelementausgabe für mehrere Seiten freigegeben werden kann.

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

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse, wobei die Zwischenspeicherdauer, alle GET Werte POST , Steuerelementnamen, benutzerdefinierte Zwischenspeicherungsanforderungen, die zum Variieren des Caches, der Datenbankabhängigkeiten verwendet werden, und ob die Ausgabe des Benutzersteuerelements für mehrere Seiten freigegeben werden kann.

PartialCachingAttribute(Int32)

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse mit der angegebenen Dauer, die dem Benutzersteuerelement zugewiesen ist, um zwischengespeichert zu werden.

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 sollte ein Benutzersteuerelement im Ausgabecache verbleiben.

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, wobei die Zwischenspeicherdauer, alle GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung angegeben werden, die zum Variieren des Caches verwendet werden.

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, in der das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Standardmäßig entsprechen diese Zeichenfolgen einem Abfragezeichenfolgenwert, der mit GET-Methodenattributen oder einem Parameter gesendet wird, der mit der POST-Methode gesendet wird. Wenn dieses Attribut auf mehrere Parameter festgelegt ist, enthält der Ausgabecache eine andere Version des angeforderten Dokuments für jeden angegebenen Parameter. Mögliche Werte sind "none", "*" und alle gültigen Abfragezeichenfolgen- oder POST-Parameternamen.

varyByControls
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Diese Zeichenfolgen stellen vollqualifizierte Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, ist die Ausgabe des Benutzersteuerelements in den Cache für jede angegebene Benutzersteuerelementeigenschaft unterschiedlich.

varyByCustom
String

Jeder Text, der benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung darstellt. Wenn dieser Parameter einen Wert von "browser" erhält, ist der Cache nach Browsername und Hauptversionsinformationen unterschiedlich. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die Methode in der GetVaryByCustomString(HttpContext, String) Datei "Global.asax" Ihrer 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 state angeben, für das die Ausgabe des Benutzersteuerelements unterschiedlich ist.

// 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, wobei die Zwischenspeicherdauer, alle GET Werte POST , Steuerelementnamen, benutzerdefinierte Zwischenspeicherungsanforderungen, die verwendet werden, um den Cache zu variieren, und ob die Benutzersteuerelementausgabe für mehrere Seiten freigegeben werden kann.

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, in der das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Standardmäßig entsprechen diese Zeichenfolgen einem Abfragezeichenfolgenwert, der mit GET Methodenattributen gesendet wird, oder einem Parameter, der mit der POST Methode gesendet wird. Wenn dieses Attribut auf mehrere Parameter festgelegt ist, enthält der Ausgabecache eine andere Version des angeforderten Dokuments für jeden angegebenen Parameter. Mögliche Werte sind "none", "*" und alle gültigen Abfragezeichenfolgen- oder POST Parameternamen.

varyByControls
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Diese Zeichenfolgen stellen vollqualifizierte Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, ist die Ausgabe des Benutzersteuerelements in den Cache für jede angegebene Benutzersteuerelementeigenschaft unterschiedlich.

varyByCustom
String

Jeder Text, der benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung darstellt. Wenn dieser Parameter einen Wert von "browser" erhält, ist der Cache nach Browsername und Hauptversionsinformationen unterschiedlich. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die Methode in der GetVaryByCustomString(HttpContext, String) Datei "Global.asax" Ihrer Anwendung überschreiben.

shared
Boolean

trueum anzugeben, dass die Benutzersteuerungsausgabe für mehrere Seiten freigegeben werden kann; andernfalls . false

Gilt für:

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

Initialisiert eine neue Instanz der PartialCachingAttribute Klasse, wobei die Zwischenspeicherdauer, alle GET Werte POST , Steuerelementnamen, benutzerdefinierte Zwischenspeicherungsanforderungen, die zum Variieren des Caches, der Datenbankabhängigkeiten verwendet werden, und ob die Ausgabe des Benutzersteuerelements für mehrere Seiten freigegeben werden kann.

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, in der das Benutzersteuerelement zwischengespeichert wird.

varyByParams
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Standardmäßig entsprechen diese Zeichenfolgen einem Abfragezeichenfolgenwert, der mit GET Methodenattributen gesendet wird, oder einem Parameter, der mit der POST Methode gesendet wird. Wenn dieses Attribut auf mehrere Parameter festgelegt ist, enthält der Ausgabecache eine andere Version des angeforderten Dokuments für jeden angegebenen Parameter. Mögliche Werte sind "none", "*" und alle gültigen Abfragezeichenfolgen- oder POST Parameternamen.

varyByControls
String

Eine durch Semikolons getrennte Liste von Zeichenfolgen, die verwendet werden, um den Ausgabecache zu variieren. Diese Zeichenfolgen stellen vollqualifizierte Namen von Eigenschaften in einem Benutzersteuerelement dar. Wenn dieser Parameter für ein Benutzersteuerelement verwendet wird, ist die Ausgabe des Benutzersteuerelements in den Cache für jede angegebene Benutzersteuerelementeigenschaft unterschiedlich.

varyByCustom
String

Jeder Text, der benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung darstellt. Wenn dieser Parameter einen Wert von "browser" erhält, ist der Cache nach Browsername und Hauptversionsinformationen unterschiedlich. Wenn eine benutzerdefinierte Zeichenfolge eingegeben wird, müssen Sie die Methode in der GetVaryByCustomString(HttpContext, String) Datei "Global.asax" Ihrer Anwendung überschreiben.

sqlDependency
String

Eine durch Trennzeichen getrennte Liste von Datenbanknamen und Tabellennamen, die bei Änderung explizit einen Cacheeintrag im ASP.NET-Cache ablaufen. Diese Datenbanknamen entsprechen diesen SQL Server Cacheabhängigkeiten, die im Abschnitt "Webkonfiguration" identifiziert wurden.

shared
Boolean

trueum anzugeben, dass die Benutzersteuerungsausgabe für mehrere Seiten freigegeben werden kann; andernfalls . false

Gilt für: