Freigeben über

HttpCachePolicy.SetETag-Methode

  • Artikel

Legt den ETag-HTTP-Header auf die angegebene Zeichenfolge fest.

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

Syntax

'Declaration
Public Sub SetETag ( _
    etag As String _
)
'Usage
Dim instance As HttpCachePolicy
Dim etag As String

instance.SetETag(etag)

public void SetETag (
    string etag
)

public:
void SetETag (
    String^ etag
)

public void SetETag (
    String etag
)

public function SetETag (
    etag : String
)

Parameter

  • etag
    Der Text, der für den ETag-Header verwendet werden soll.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

etag ist NULL (Nothing in Visual Basic).

InvalidOperationException

Der ETag-Header wurde bereits festgelegt.

– oder –

SetETagFromFileDependencies wurde bereits aufgerufen.

Hinweise

Der ETag-Header ist ein eindeutiger Bezeichner für eine bestimmte Version eines Dokuments. Er wird von Clients zum Überprüfen des vom Client zwischengespeicherten Inhalts verwendet, um eine erneute Anforderung zu vermeiden. Nachdem ein ETag-Header festgelegt wurde, schlagen nachfolgende Versuche, ihn festzulegen, fehl. In diesem Fall wird eine Ausnahme ausgelöst.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie der ETag-Header auf einen benutzerdefinierten Wert festgelegt wird.

Response.Cache.SetETag("50f59e42f4d8bc1:cd7")
 

Response.Cache.SetETag("50f59e42f4d8bc1:cd7");
 

get_Response().get_Cache().SetETag("50f59e42f4d8bc1:cd7");

Response.Cache.SetETag("50f59e42f4d8bc1:cd7")

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

HttpCachePolicy-Klasse
HttpCachePolicy-Member
System.Web-Namespace