PartialCachingAttribute Konstruktoren
Definition
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.
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. |
| PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. |
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.PartialCachingAttributePublic 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.PartialCachingAttributePublic 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.PartialCachingAttributePublic 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.PartialCachingAttributePublic 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.