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。

範例

下列範例會使用 Add 方法，將名稱/值組新增至 WebHeaderCollection 。

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 和 .NET Core 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如果的長度value大於 65535，則搭配類型HttpResponseHeader之任何標頭使用的實例會擲回 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如果的長度value大於 65535，則搭配類型HttpResponseHeader之任何標頭使用的實例會擲回 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。

範例

下列範例會使用 Add 方法，將名稱/值組新增至 WebHeaderCollection 。

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如果的長度value大於 65535，則搭配類型HttpResponseHeader之任何標頭使用的實例會擲回 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)

參數

例外狀況

範例

備註

適用於

其他資源