WebHeaderCollection.Add 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將新標頭插入至集合。
多載
Add(String) |
將指定標頭插入至集合。 |
Add(HttpRequestHeader, String) |
將具有指定值的指定標頭插入至集合。 |
Add(HttpResponseHeader, String) |
將具有指定值的指定標頭插入至集合。 |
Add(String, String) |
將具有指定名稱和值的標頭插入至集合。 |
Add(String)
將指定標頭插入至集合。
public:
void Add(System::String ^ header);
public void Add (string header);
override this.Add : string -> unit
Public Sub Add (header As String)
參數
- header
- String
要加入的標頭,具有以冒號分隔的名稱和值。
例外狀況
header
是 null
或 Empty。
header
不包含冒號 (:) 字元。
value
的長度大於 65535。
-或-
header
的名稱部分是 Empty 或含有無效字元。
-或-
header
是應該使用屬性設定之受限制的標頭。
-或-
header
的值部分包含無效字元。
僅限 .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)
將具有指定值的指定標頭插入至集合。
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
標頭的內容。
例外狀況
僅限 .NET Framework 與 .NET Core 2.0 - 3.1 版:value
的長度大於 65535。
這個 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)
將具有指定值的指定標頭插入至集合。
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
標頭的內容。
例外狀況
僅限 .NET Framework 與 .NET Core 2.0 - 3.1 版:value
的長度大於 65535。
這個 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)
將具有指定名稱和值的標頭插入至集合。
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
標頭的內容。
例外狀況
僅限 .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
現有逗號分隔值清單。