Freigeben über


HttpCacheVaryByParams.Item-Eigenschaft

Ruft einen Wert ab, der angibt, ob der Cache je nach dem angegebenen HTTP-Anforderungsparameter geändert wird, oder legt diesen fest.

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

Syntax

'Declaration
Public Default Property Item ( _
    header As String _
) As Boolean
'Usage
Dim instance As HttpCacheVaryByParams
Dim header As String
Dim value As Boolean

value = instance(header)

instance(header) = value
public bool this [
    string header
] { get; set; }
public:
property bool default [String^] {
    bool get (String^ header);
    void set (String^ header, bool value);
}
/** @property */
public boolean get_Item (String header)

/** @property */
public void set_Item (String header, boolean value)
JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

  • header
    Der Name des benutzerdefinierten Parameters.

Eigenschaftenwert

true, wenn der Cache durch den angegebenen Parameterwert geändert werden soll.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

header ist NULL (Nothing in Visual Basic).

Hinweise

Bei Verwendung als Accessor (Getter) gibt der Item-Indexer true zurück, wenn der Wert für den angegebenen Parameter in der aktuellen Parameterauflistung gefunden wurde oder wenn die Auflistung so festgelegt ist, dass sie sich durch * (ein Sternchen) unterscheidet. Damit werden alle Parameter angegeben.

Bei Verwendung als Mutator (Setter) legt der Item-Indexer den Wert für den Parameter in der Parameterauflistung fest, der dem angegebenen, auf true festgelegten Header entspricht. Der Wert * kann angegeben werden. Damit werden alle Parameter angegeben.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie vom HttpCachePolicy-Objekt, das einer HttpResponse zugeordnet ist, auf den Item-Indexer zugegriffen wird.

Response.Cache.SetExpires(DateTime.Now.AddSeconds(60))
Response.Cache.SetCacheability(HttpCacheability.Public)
Response.Cache.SetValidUntilExpires(False)
Response.Cache.VaryByParams("Category") = True

If Response.Cache.VaryByParams("Category") Then
   '...
End If
 
Response.Cache.SetExpires(DateTime.Now.AddSeconds(60));
Response.Cache.SetCacheability(HttpCacheability.Public);
Response.Cache.SetValidUntilExpires(false);
Response.Cache.VaryByParams["Category"] = true;

if (Response.Cache.VaryByParams["Category"])
{
   //...
}
get_Response().get_Cache().SetExpires(DateTime.get_Now().
    AddSeconds(60));
get_Response().get_Cache().SetCacheability(HttpCacheability.Public);
get_Response().get_Cache().SetValidUntilExpires(false);
get_Response().get_Cache().get_VaryByParams().
    set_Item("Category", true);

if (get_Response().get_Cache().get_VaryByParams().
    get_Item("Category")) {
    //...
}
Response.Cache.SetExpires(DateTime.Now.AddSeconds(60))
Response.Cache.SetCacheability(HttpCacheability.Public)
Response.Cache.SetValidUntilExpires(false)
Response.Cache.VaryByParams("Category") = true

if(Response.Cache.VaryByParams("Category")){
   //...
}
 

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

HttpCacheVaryByParams-Klasse
HttpCacheVaryByParams-Member
System.Web-Namespace

Weitere Ressourcen

Gewusst wie: Zwischenspeichern von Versionen einer Seite mithilfe von Parametern
Zwischenspeichern mehrerer Versionen einer Seite