HttpCachePolicy.SetETag メソッド

.NET Framework クラス ライブラリ リファレンス

HttpCachePolicy.SetETag メソッド

ETag HTTP ヘッダーを指定文字列に設定します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub SetETag ( _
    etag As String _
)

Visual Basic (使用法)

Dim instance As HttpCachePolicy
Dim etag As String

instance.SetETag(etag)

C#

public void SetETag (
    string etag
)

C++

public:
void SetETag (
    String^ etag
)

J#

public void SetETag (
    String etag
)

JScript

public function SetETag (
    etag : String
)

パラメータ

etag

ETag ヘッダーに使用するテキスト。

例外

例外の種類	条件
ArgumentNullException	etag が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	ETag ヘッダーが既に設定されています。 または SetETagFromFileDependencies が既に呼び出されています。

解説

ETag ヘッダーは、ドキュメントの特定のバージョンを表す一意の識別子です。これは、クライアントにキャッシュされたコンテンツを再度要求しないように、クライアントがコンテンツの検証に使用します。ETag ヘッダーを設定した後で、このヘッダーを設定しようとすると失敗し、例外がスローされます。

使用例

ETag ヘッダーをカスタム値に設定する方法を次のコード例に示します。

Visual Basic

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

C#

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

J#

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

JScript

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

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HttpCachePolicy クラス
HttpCachePolicy メンバ
System.Web 名前空間