HttpListenerResponse.Headers プロパティ

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

HttpListenerResponse.Headers プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

サーバーから返されるヘッダーの名前と値のペアのコレクションを取得または設定します。

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

Visual Basic (宣言)

Public Property Headers As
 WebHeaderCollection

Visual Basic (使用法)

Dim instance As HttpListenerResponse
Dim value As WebHeaderCollection

value = instance.Headers

instance.Headers = value

C#

public WebHeaderCollection Headers { get; set;
 }

C++

public:
property WebHeaderCollection^ Headers {
    WebHeaderCollection^ get ();
    void set (WebHeaderCollection^ value);
}

J#

/** @property */
public WebHeaderCollection get_Headers ()

/** @property */
public void set_Headers (WebHeaderCollection
 value)

JScript

public function get Headers
 () : WebHeaderCollection

public function set Headers
 (value : WebHeaderCollection)

プロパティ値
応答に挿入される、明示的に設定されたすべての HTTP ヘッダーを格納している WebHeaderCollection インスタンス。

例外

例外の種類	条件
InvalidOperationException	設定操作に指定された WebHeaderCollection インスタンスが、応答では無効です。

解説

応答ヘッダーには、応答の日時、応答元サーバーの ID、応答本体に格納されているデータの MIME タイプなどのメタデータ情報が格納されます。

応答ヘッダーの完全な一覧については、HttpResponseHeader 列挙体を参照してください。

メモ
Headers プロパティを使用して Content-Length、Keep-Alive、Transfer-Encoding、または WWW-Authenticate ヘッダーを設定しようとすると、例外がスローされます。これらのヘッダーを設定するには、KeepAlive プロパティまたは ContentLength64 プロパティを使用してください。Transfer-Encoding ヘッダーと WWW-Authenticate ヘッダーは、手動では設定できません。

使用例

WebHeaderCollection に含まれるヘッダーを表示するコード例を次に示します。

C#

    // Displays the header information that accompanied a request.
public static void DisplayWebHeaderCollection(HttpListenerResponse
 response)
{
    WebHeaderCollection headers = response.Headers;
    // Get each header and display each value.
    foreach (string key in
 headers.AllKeys)
    {
        string[] values = headers.GetValues(key);
        if(values.Length > 0) 
        {
            Console.WriteLine("The values of the {0} header are: ", key);
            foreach (string value in
 values) 
            {
                Console.WriteLine("   {0}", value);
            }
        }
        else
            Console.WriteLine("There is no value associated with the header.");
    }
}

プラットフォーム

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListenerResponse クラス
HttpListenerResponse メンバ
System.Net 名前空間
HttpListener クラス
HttpListenerContext クラス
HttpListenerRequest クラス