HttpCachePolicy.SetETag(String) Methode

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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.

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

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.

Ausnahmen

ArgumentNullException

etag ist null.

InvalidOperationException

Der ETag-Header wurde bereits festgelegt.

- oder -

SetETagFromFileDependencies() wurde bereits aufgerufen.

Beispiele

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""")

Hinweise

Der ETag Header ist ein eindeutiger Bezeichner für eine bestimmte Version eines Dokuments. Es wird von Clients verwendet, um zwischengespeicherte Inhalte zu überprüfen, um eine erneute Anforderung zu vermeiden. Sobald ein ETag Header festgelegt wurde, schlagen nachfolgende Versuche, ihn festzulegen, fehl, und es wird eine Ausnahme ausgelöst.

SetETagwird in der .NET Framework Version 3.5 eingeführt. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Gilt für: