WebHeaderCollection.Add メソッド

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.WebHeaderCollection.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

新しいヘッダーをコレクションに挿入します。

オーバーロード

Add(String)	指定したヘッダーをコレクションに挿入します。
Add(HttpRequestHeader, String)	指定した値を持つ、指定したヘッダーをコレクションに挿入します。
Add(HttpResponseHeader, String)	指定した値を持つ、指定したヘッダーをコレクションに挿入します。
Add(String, String)	指定した名前と値のヘッダーをコレクションに挿入します。

Add(String)

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

指定したヘッダーをコレクションに挿入します。

public:
 void Add(System::String ^ header);

public void Add (string header);

override this.Add : string -> unit

Public Sub Add (header As String)

パラメーター

header: String

追加するヘッダー。コロンで名前と値を区切ります。

例外

ArgumentNullException

header は null または Empty です。

ArgumentException

header に、コロン (:) 文字が含まれていません。

value の長さが 65535 を超えています。

- または -

header の名前部分が Empty です。または無効な文字が含まれています。

- または -

header が、プロパティで設定する必要がある制限付きヘッダーです。

- または -

header の値部分に無効な文字が含まれています。

ArgumentOutOfRangeException

.NET Framework および .NET Core バージョン 2.0 - 3.1 のみ: コロン (:) の後の文字列の長さが 65535 文字を超えています。

例

次の例では、メソッドを使用して、名前と値の WebHeaderCollection ペアを Add に追加します。

try
{
   //Create a web request for S"www.msn.com".
   HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.msn.com" ));

   //Get the headers associated with the request.
   WebHeaderCollection^ myWebHeaderCollection = myHttpWebRequest->Headers;
   Console::WriteLine( "Configuring Webrequest to accept Danish and English language using 'Add' method" );

   //Add the Accept-Language header (for Danish) in the request.
   myWebHeaderCollection->Add( "Accept-Language:da" );

   //Include English in the Accept-Langauge header.
   myWebHeaderCollection->Add( "Accept-Language:en;q=0.8" );

   //Get the associated response for the above request.
   HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());

   //Print the headers for the request.
   printHeaders( myWebHeaderCollection );
   myHttpWebResponse->Close();
}
//Catch exception if trying to add a restricted header.
catch ( ArgumentException^ e ) 
{
   Console::WriteLine( e->Message );
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "\nWebException is thrown. \nMessage is : {0}", e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusCode );
      Console::WriteLine( "Status Description : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      Console::WriteLine( "Server : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->Server );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception is thrown. Message is : {0}", e->Message );
}

try {
    //Create a web request for "www.msn.com".
    HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("http://www.msn.com");

    //Get the headers associated with the request.
    WebHeaderCollection myWebHeaderCollection = myHttpWebRequest.Headers;

    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method");

    //Add the Accept-Language header (for Danish) in the request.
    myWebHeaderCollection.Add("Accept-Language:da");

    //Include English in the Accept-Langauge header. 
    myWebHeaderCollection.Add("Accept-Language","en;q=0.8");

    //Get the associated response for the above request.
    HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();

    //Print the headers for the request.
    printHeaders(myWebHeaderCollection);
    myHttpWebResponse.Close();
}
//Catch exception if trying to add a restricted header.
catch(ArgumentException e) {
    Console.WriteLine(e.Message);
}
catch(WebException e) {
    Console.WriteLine("\nWebException is thrown. \nMessage is :" + e.Message);
    if(e.Status == WebExceptionStatus.ProtocolError) {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode);
        Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription);
        Console.WriteLine("Server : {0}", ((HttpWebResponse)e.Response).Server);
    }
}
catch(Exception e) {
    Console.WriteLine("Exception is thrown. Message is :" + e.Message);
}

Public Shared Sub Main()

 Try
        'Create a web request for "www.msn.com".
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.msn.com"), HttpWebRequest)
        
        'Get the headers associated with the request.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebRequest.Headers
        
    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method")
        
    'Add the Accept-Language header (for Danish) in the request.
        myWebHeaderCollection.Add("Accept-Language:da")
        
        'Include English in the Accept-Langauge header. 
        myWebHeaderCollection.Add("Accept-Language","en;q" + ChrW(61) + "0.8")
        
        'Get the associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Print the headers for the request.
        printHeaders(myWebHeaderCollection)
        myHttpWebResponse.Close()
    'Catch exception if trying to add a restricted header.
    Catch e As ArgumentException
        Console.WriteLine(e.Message)
    Catch e As WebException
        Console.WriteLine(e.Message)
        If e.Status = WebExceptionStatus.ProtocolError Then
            Console.WriteLine("Status Code : {0}", CType(e.Response, HttpWebResponse).StatusCode)
            Console.WriteLine("Status Description : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
            Console.WriteLine("Server : {0}", CType(e.Response, HttpWebResponse).Server)
        End If
    Catch e As Exception
        Console.WriteLine(e.Message)
    End Try
End Sub

注意

の値部分 headerの長さ、つまりコロンの後の文字列 (:)) は、.NET Framework バージョン 2.0 ~ 3.1 でのみ検証されます。

該当するすべての .NET Framework バージョンで: WebHeaderCollection の値部分headerの長さが 65535 を超える場合、プロパティによってHeaders返されるインスタンスはをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さの値を受け入れます。
バージョン 3.1 以降の .NET Core バージョンでは、 WebHeaderCollection の値部分headerの長さが 65535 より大きい場合、型HttpResponseHeaderの任意のヘッダーで使用されるインスタンスはをスローArgumentOutOfRangeExceptionします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さの値を受け入れます。
.NET 5 以降のバージョンでは、は WebHeaderCollection 任意の長さの値を受け入れます。

注釈

パラメーターは header 、"name:value" 形式で指定する必要があります。指定したヘッダーがコレクションに存在しない場合は、新しいヘッダーがコレクションに追加されます。

で header 指定されたヘッダーがコレクションに既に存在する場合、の値部分は既存の header 値と連結されます。

適用対象

Add(HttpRequestHeader, String)

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

指定した値を持つ、指定したヘッダーをコレクションに挿入します。

public:
 void Add(System::Net::HttpRequestHeader header, System::String ^ value);

public void Add (System.Net.HttpRequestHeader header, string? value);

public void Add (System.Net.HttpRequestHeader header, string value);

override this.Add : System.Net.HttpRequestHeader * string -> unit

Public Sub Add (header As HttpRequestHeader, value As String)

パラメーター

header: HttpRequestHeader

コレクションに追加するヘッダー。

value: String

ヘッダーの内容。

例外

ArgumentOutOfRangeException

.NET Framework および .NET Core バージョン 2.0 - 3.1 のみ: value の長さが 65535 文字を超えています。

InvalidOperationException

この WebHeaderCollection インスタンスは、HttpRequestHeader のインスタンスを許可しません。

注釈

指定したヘッダーが存在しない場合、メソッドは Add ヘッダー名と値のペアの一覧に新しいヘッダーを挿入します。

指定したヘッダーが既に存在する場合は、 value がヘッダーに関連付けられている値のコンマ区切りのリストに追加されます。

注意

の value 長さは、.NET Framework および .NET Core バージョン 2.0 から 3.1 でのみ検証されます。

該当するすべての .NET Framework バージョンで: WebHeaderCollection の長さが value 65535 を超える場合、プロパティによってHeaders返されるインスタンスはをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET Core バージョンからバージョン 3.1: WebHeaderCollection 型HttpResponseHeaderの任意のヘッダーで使用されるインスタンスは、のvalue長さが 65535 を超える場合にをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET 5 以降のバージョンでは、は WebHeaderCollection 任意の長さのを value 受け入れます。

適用対象

Add(HttpResponseHeader, String)

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

指定した値を持つ、指定したヘッダーをコレクションに挿入します。

public:
 void Add(System::Net::HttpResponseHeader header, System::String ^ value);

public void Add (System.Net.HttpResponseHeader header, string? value);

public void Add (System.Net.HttpResponseHeader header, string value);

override this.Add : System.Net.HttpResponseHeader * string -> unit

Public Sub Add (header As HttpResponseHeader, value As String)

パラメーター

header: HttpResponseHeader

コレクションに追加するヘッダー。

value: String

ヘッダーの内容。

例外

ArgumentOutOfRangeException

.NET Framework および .NET Core バージョン 2.0 - 3.1 のみ: value の長さが 65535 文字を超えています。

InvalidOperationException

この WebHeaderCollection インスタンスは、HttpResponseHeader のインスタンスを許可しません。

注釈

指定したヘッダーが存在しない場合、メソッドは Add ヘッダー名と値のペアの一覧に新しいヘッダーを挿入します。

指定したヘッダーが既に存在する場合は、 value がヘッダーに関連付けられている値のコンマ区切りのリストに追加されます。

注意

の value 長さは、.NET Framework および .NET Core バージョン 2.0 から 3.1 でのみ検証されます。

該当するすべての .NET Framework バージョンで: WebHeaderCollection の長さが value 65535 を超える場合、プロパティによってHeaders返されるインスタンスはをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET Core バージョンからバージョン 3.1: WebHeaderCollection 型HttpResponseHeaderの任意のヘッダーで使用されるインスタンスは、のvalue長さが 65535 を超える場合にをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET 5 以降のバージョンでは、は WebHeaderCollection 任意の長さのを value 受け入れます。

適用対象

Add(String, String)

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

ソース:: WebHeaderCollection.cs

指定した名前と値のヘッダーをコレクションに挿入します。

public:
 override void Add(System::String ^ name, System::String ^ value);

public override void Add (string name, string? value);

public override void Add (string name, string value);

override this.Add : string * string -> unit

Public Overrides Sub Add (name As String, value As String)

パラメーター

name: String

コレクションに追加するヘッダー。

value: String

ヘッダーの内容。

例外

ArgumentException

name が null または Empty です。または、無効な文字が含まれています。

- または -

name が、プロパティで設定する必要がある制限付きヘッダーです。

- または -

value に無効な文字が含まれています。

ArgumentOutOfRangeException

.NET Framework および .NET Core バージョン 2.0 - 3.1 のみ: value の長さが 65535 文字を超えています。

例

次の例では、メソッドを使用して、名前と値の WebHeaderCollection ペアを Add に追加します。

try
{
   //Create a web request for S"www.msn.com".
   HttpWebRequest^ myHttpWebRequest = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.msn.com" ));

   //Get the headers associated with the request.
   WebHeaderCollection^ myWebHeaderCollection = myHttpWebRequest->Headers;
   Console::WriteLine( "Configuring Webrequest to accept Danish and English language using 'Add' method" );

   //Add the Accept-Language header (for Danish) in the request.
   myWebHeaderCollection->Add( "Accept-Language:da" );

   //Include English in the Accept-Langauge header.
   myWebHeaderCollection->Add( "Accept-Language:en;q=0.8" );

   //Get the associated response for the above request.
   HttpWebResponse^ myHttpWebResponse = dynamic_cast<HttpWebResponse^>(myHttpWebRequest->GetResponse());

   //Print the headers for the request.
   printHeaders( myWebHeaderCollection );
   myHttpWebResponse->Close();
}
//Catch exception if trying to add a restricted header.
catch ( ArgumentException^ e ) 
{
   Console::WriteLine( e->Message );
}
catch ( WebException^ e ) 
{
   Console::WriteLine( "\nWebException is thrown. \nMessage is : {0}", e->Message );
   if ( e->Status == WebExceptionStatus::ProtocolError )
   {
      Console::WriteLine( "Status Code : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusCode );
      Console::WriteLine( "Status Description : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      Console::WriteLine( "Server : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->Server );
   }
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Exception is thrown. Message is : {0}", e->Message );
}

try {
    //Create a web request for "www.msn.com".
    HttpWebRequest myHttpWebRequest = (HttpWebRequest) WebRequest.Create("http://www.msn.com");

    //Get the headers associated with the request.
    WebHeaderCollection myWebHeaderCollection = myHttpWebRequest.Headers;

    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method");

    //Add the Accept-Language header (for Danish) in the request.
    myWebHeaderCollection.Add("Accept-Language:da");

    //Include English in the Accept-Langauge header. 
    myWebHeaderCollection.Add("Accept-Language","en;q=0.8");

    //Get the associated response for the above request.
    HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();

    //Print the headers for the request.
    printHeaders(myWebHeaderCollection);
    myHttpWebResponse.Close();
}
//Catch exception if trying to add a restricted header.
catch(ArgumentException e) {
    Console.WriteLine(e.Message);
}
catch(WebException e) {
    Console.WriteLine("\nWebException is thrown. \nMessage is :" + e.Message);
    if(e.Status == WebExceptionStatus.ProtocolError) {
        Console.WriteLine("Status Code : {0}", ((HttpWebResponse)e.Response).StatusCode);
        Console.WriteLine("Status Description : {0}", ((HttpWebResponse)e.Response).StatusDescription);
        Console.WriteLine("Server : {0}", ((HttpWebResponse)e.Response).Server);
    }
}
catch(Exception e) {
    Console.WriteLine("Exception is thrown. Message is :" + e.Message);
}

Public Shared Sub Main()

 Try
        'Create a web request for "www.msn.com".
        Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.msn.com"), HttpWebRequest)
        
        'Get the headers associated with the request.
        Dim myWebHeaderCollection As WebHeaderCollection = myHttpWebRequest.Headers
        
    Console.WriteLine("Configuring Webrequest to accept Danish and English language using 'Add' method")
        
    'Add the Accept-Language header (for Danish) in the request.
        myWebHeaderCollection.Add("Accept-Language:da")
        
        'Include English in the Accept-Langauge header. 
        myWebHeaderCollection.Add("Accept-Language","en;q" + ChrW(61) + "0.8")
        
        'Get the associated response for the above request.
        Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
        
        'Print the headers for the request.
        printHeaders(myWebHeaderCollection)
        myHttpWebResponse.Close()
    'Catch exception if trying to add a restricted header.
    Catch e As ArgumentException
        Console.WriteLine(e.Message)
    Catch e As WebException
        Console.WriteLine(e.Message)
        If e.Status = WebExceptionStatus.ProtocolError Then
            Console.WriteLine("Status Code : {0}", CType(e.Response, HttpWebResponse).StatusCode)
            Console.WriteLine("Status Description : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
            Console.WriteLine("Server : {0}", CType(e.Response, HttpWebResponse).Server)
        End If
    Catch e As Exception
        Console.WriteLine(e.Message)
    End Try
End Sub

注意

の value 長さは、.NET Framework および .NET Core バージョン 2.0 から 3.1 でのみ検証されます。

該当するすべての .NET Framework バージョンで: WebHeaderCollection の長さが value 65535 を超える場合、プロパティによってHeaders返されるインスタンスはをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET Core バージョンからバージョン 3.1: WebHeaderCollection 型HttpResponseHeaderの任意のヘッダーで使用されるインスタンスは、のvalue長さが 65535 を超える場合にをArgumentOutOfRangeExceptionスローします。その他 WebHeaderCollection のすべてのインスタンスは、任意の長さのを value 受け入れます。
.NET 5 以降のバージョンでは、は WebHeaderCollection 任意の長さのを value 受け入れます。

注釈

で name 指定されたヘッダーが存在しない場合、メソッドは Add ヘッダー名と値のペアの一覧に新しいヘッダーを挿入します。

で指定されたヘッダーが既に name 存在する場合は、 value に関連付けられている name値のコンマ区切りの既存のリストにが追加されます。

適用対象

次の方法で共有

WebHeaderCollection.Add メソッド

定義

オーバーロード

Add(String)

パラメーター

例外

例

注釈

適用対象

Add(HttpRequestHeader, String)

パラメーター

例外

注釈

適用対象

Add(HttpResponseHeader, String)

パラメーター

例外

注釈

適用対象

Add(String, String)

パラメーター

例外

例

注釈

適用対象

その他のリソース