HttpCachePolicy.SetETag(String) Methode

Definition

Legt den ETag-HTTP-Header auf die angegebene Zeichenfolge fest.Sets the ETag HTTP header to the specified string.

public:
 void SetETag(System::String ^ etag);
public void SetETag (string etag);
member this.SetETag : string -> unit
Public Sub SetETag (etag As String)

Parameter

etag
String

Der Text, der für den ETag-Header verwendet werden soll.The text to use for the ETag header.

Ausnahmen

etag ist null.etag is null.

Der ETag-Header wurde bereits festgelegt.The ETag header has already been set.

- oder --or- SetETagFromFileDependencies() wurde bereits aufgerufen.The SetETagFromFileDependencies() has already been called.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der ETag -Header auf einen benutzerdefinierten Wert festgelegt wird.The following code example demonstrates how to set the ETag header to a custom value.

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

Hinweise

Der ETag -Header ist ein eindeutiger Bezeichner für eine bestimmte Version eines Dokuments.The ETag header is a unique identifier for a specific version of a document. Sie wird von Clients verwendet, um den vom Client zwischengespeicherten Inhalt zu überprüfen, um ihn nicht erneut anzufordern.It is used by clients to validate client-cached content to avoid requesting it again. Nachdem ein ETag Header festgelegt wurde, schlagen nachfolgende Versuche, ihn festzulegen, fehl, und es wird eine Ausnahme ausgelöst.Once an ETag header is set, subsequent attempts to set it fail and an exception is thrown.

SetETagwird in der .NET Framework Version 3,5 eingeführt.SetETag is introduced in the .NET Framework version 3.5. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.For more information, see Versions and Dependencies.

Gilt für: