PartialCachingAttribute-Konstruktor (Int32, String, String, String)

Artikel
08/20/2007

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.

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

Syntax

'Declaration
Public Sub New ( _
    duration As Integer, _
    varyByParams As String, _
    varyByControls As String, _
    varyByCustom As String _
)
'Usage
Dim duration As Integer
Dim varyByParams As String
Dim varyByControls As String
Dim varyByCustom As String

Dim instance As New PartialCachingAttribute(duration, varyByParams, varyByControls, varyByCustom)

public PartialCachingAttribute (
    int duration,
    string varyByParams,
    string varyByControls,
    string varyByCustom
)

public:
PartialCachingAttribute (
    int duration, 
    String^ varyByParams, 
    String^ varyByControls, 
    String^ varyByCustom
)

public PartialCachingAttribute (
    int duration, 
    String varyByParams, 
    String varyByControls, 
    String varyByCustom
)

public function PartialCachingAttribute (
    duration : int, 
    varyByParams : String, 
    varyByControls : String, 
    varyByCustom : String
)

Parameter

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

varyByParams
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
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
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 HttpApplication.GetVaryByCustomString-Methode in der Datei Global.asax der Anwendung überschreiben.

Beispiel

Im folgenden Codebeispiel wird eine Möglichkeit veranschaulicht, den PartialCachingAttribute(Int32,String,String,String)-Konstruktor auf ein Benutzersteuerelement anzuwenden. Im Beispiel wird mit dem Konstruktor angegeben, dass das Benutzersteuerelement zwischengespeichert werden kann und die Dauer für die Zwischenspeicherung 20 Sekunden beträgt. Außerdem wird ein Steuerelement mit dem Namen state angegeben, dessen Ausgabe von Benutzersteuerelementen variiert 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, Nothing, "state", Nothing)> _
Public Class ctlSelect
    Inherits UserControl

// 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.
/** @attribute PartialCaching(20, null, "state", null)
 */

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PartialCachingAttribute-Klasse
PartialCachingAttribute-Member
System.Web.UI-Namespace

Freigeben über