WebRequest.Headers プロパティ

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

WebRequest.Headers プロパティ

派生クラスでオーバーライドされると、要求に関連付けられたヘッダーの名前/値ペアのコレクションを取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 Headers As WebHeaderCollection

Visual Basic (使用法)

Dim instance As WebRequest
Dim value As WebHeaderCollection

value = instance.Headers

instance.Headers = value

C#

public virtual WebHeaderCollection Headers { get;
 set; }

C++

public:
virtual 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)

プロパティ値
要求に関連付けられたヘッダーの名前/値ペアを格納する WebHeaderCollection。

例外

例外の種類	条件
NotImplementedException	プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。

解説

Headers プロパティは、インターネット リソースに送信するヘッダー情報を含む WebHeaderCollection インスタンスを格納します。

メモ
WebRequest クラスは、abstract クラスです。実行時の WebRequest インスタンスの実際の動作は、System.Net.WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。

使用例

この要求に関連付けられているヘッダーの名前/値ペアを表示する例を次に示します。

Visual Basic

    ' Create a new request to the mentioned URL.    
    Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")
    
   ' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
   
    Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
   ' Release the resources of response object.
   
 myWebResponse.Close()
Console.WriteLine(ControlChars.Cr + "The HttpHeaders are "
 + ControlChars.Cr + "{0}", myWebRequest.Headers)

C#

         // Create a new request to the mentioned URL.    
WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");
        

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

// Release the resources of response object.
myWebResponse.Close();
Console.WriteLine("\nThe HttpHeaders are \n{0}",myWebRequest.Headers);    

C++

// Create a new request to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.contoso.com"
 );

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Release the resources of response object.
myWebResponse->Close();
Console::WriteLine( "\nThe HttpHeaders are \n {0}", myWebRequest->Headers
 );

J#

// Create a new request to the mentioned URL.    
WebRequest myWebRequest = WebRequest.Create("http://www.contoso.com");
// Assign the response object of 'WebRequest' to a
// 'WebResponse' variable.
WebResponse myWebResponse = myWebRequest.GetResponse();
// Release the resources of response object.
myWebResponse.Close();
Console.WriteLine("\nThe HttpHeaders are \n{0}", myWebRequest.
    get_Headers());

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間
WebHeaderCollection クラス
HttpWebRequest.Headers プロパティ