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
| 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 |
| PartialCachingAttribute(Int32, String, String, String, String, Boolean) |
Initialisiert eine neue Instanz der PartialCachingAttribute Klasse, wobei die Zwischenspeicherdauer, alle |
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