WebHeaderCollection.Add Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Infogar en ny rubrik i samlingen.
Överlagringar
| Name | Description |
|---|---|
| Add(String) |
Infogar det angivna huvudet i samlingen. |
| Add(HttpRequestHeader, String) |
Infogar det angivna huvudet med det angivna värdet i samlingen. |
| Add(HttpResponseHeader, String) |
Infogar det angivna huvudet med det angivna värdet i samlingen. |
| Add(String, String) |
Infogar en rubrik med det angivna namnet och värdet i samlingen. |
Add(String)
Infogar det angivna huvudet i samlingen.
public:
void Add(System::String ^ header);
public void Add(string header);
override this.Add : string -> unit
Public Sub Add (header As String)
Parametrar
- header
- String
Rubriken som ska läggas till med namnet och värdet avgränsat med ett kolon.
Undantag
header är null eller Empty.
header innehåller inte ett kolon (:) tecken.
-eller-
Längden på värdedelen av header är större än 65535.
-eller-
Namndelen av header är Empty eller innehåller ogiltiga tecken.
-eller-
header är ett begränsat huvud som ska anges med en egenskap.
-eller-
Värdedelen i header innehåller ogiltiga tecken.
.NET Framework och .NET Core version 2.0– 3.1: Längden på strängen efter kolonet (:) är större än 65535.
Exempel
I följande exempel läggs ett namn/värde-par till i ett WebHeaderCollection med hjälp av Add metoden .
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
Note
Längden på value del av header, d.v.s. strängen efter kolonet (:), verifieras endast i .NET Framework och .NET Core-versionerna 2.0–3.1.
- På alla tillämpliga .NET Framework-versioner: En WebHeaderCollection-instans som returneras av egenskapen Headers utlöser en ArgumentOutOfRangeException om längden på egenskapen value del av
headerär större än 65535. Alla andra WebHeaderCollection instanser accepterar ett värde av valfri längd. - På .NET Core-versioner via version 3.1: En WebHeaderCollection-instans som används med någon rubrik av typen HttpResponseHeader genererar en ArgumentOutOfRangeException om längden på value del av
headerär större än 65535. Alla andra WebHeaderCollection instanser accepterar ett värde av valfri längd. - På .NET 5 och senare versioner: WebHeaderCollection accepterar en value oavsett längd.
Kommentarer
Parametern header måste anges i formatet "name:value". Om det angivna huvudet inte finns i samlingen läggs ett nytt huvud till i samlingen.
Om huvudet som anges i header redan finns i samlingen sammanfogas värdedelen av det header befintliga värdet.
Gäller för
Add(HttpRequestHeader, String)
Infogar det angivna huvudet med det angivna värdet i samlingen.
public:
void Add(System::Net::HttpRequestHeader header, System::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)
Parametrar
- header
- HttpRequestHeader
Rubriken som ska läggas till i samlingen.
- value
- String
Innehållet i rubriken.
Undantag
endast .NET Framework- och .NET Core-versionerna 2.0–3.1: Längden på value är större än 65535.
Den här WebHeaderCollection instansen tillåter inte instanser av HttpRequestHeader.
Kommentarer
Om det angivna huvudet inte finns Add infogar metoden en ny rubrik i listan med rubriknamn/värdepar.
Om det angivna huvudet redan finns value läggs det till i kommaavgränsad lista med värden som är associerade med rubriken.
Note
Längden på value verifieras endast i .NET Framework och .NET Core-versionerna 2.0–3.1.
- På alla tillämpliga .NET Framework-versioner: En WebHeaderCollection-instans som returneras av egenskapen Headers genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET Core-versioner via version 3.1: En WebHeaderCollection-instans som används med någon rubrik av typen HttpResponseHeader genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET 5 och senare versioner: WebHeaderCollection accepterar en
valueoavsett längd.
Gäller för
Add(HttpResponseHeader, String)
Infogar det angivna huvudet med det angivna värdet i samlingen.
public:
void Add(System::Net::HttpResponseHeader header, System::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)
Parametrar
- header
- HttpResponseHeader
Rubriken som ska läggas till i samlingen.
- value
- String
Innehållet i rubriken.
Undantag
endast .NET Framework- och .NET Core-versionerna 2.0–3.1: Längden på value är större än 65535.
Den här WebHeaderCollection instansen tillåter inte instanser av HttpResponseHeader.
Kommentarer
Om det angivna huvudet inte finns Add infogar metoden en ny rubrik i listan med rubriknamn/värdepar.
Om det angivna huvudet redan finns value läggs det till i kommaavgränsad lista med värden som är associerade med rubriken.
Note
Längden på value verifieras endast i .NET Framework och .NET Core-versionerna 2.0–3.1.
- På alla tillämpliga .NET Framework-versioner: En WebHeaderCollection-instans som returneras av egenskapen Headers genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET Core-versioner via version 3.1: En WebHeaderCollection-instans som används med någon rubrik av typen HttpResponseHeader genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET 5 och senare versioner: WebHeaderCollection accepterar en
valueoavsett längd.
Gäller för
Add(String, String)
Infogar en rubrik med det angivna namnet och värdet i samlingen.
public:
override void Add(System::String ^ name, System::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)
Parametrar
- name
- String
Rubriken som ska läggas till i samlingen.
- value
- String
Innehållet i rubriken.
Undantag
name är null, Emptyeller innehåller ogiltiga tecken.
-eller-
name är ett begränsat huvud som måste anges med en egenskapsinställning.
-eller-
value innehåller ogiltiga tecken.
endast .NET Framework- och .NET Core-versionerna 2.0–3.1: Längden på value är större än 65535.
Exempel
I följande exempel läggs ett namn/värde-par till i ett WebHeaderCollection med hjälp av Add metoden .
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
Note
Längden på value verifieras endast i .NET Framework och .NET Core-versionerna 2.0–3.1.
- På alla tillämpliga .NET Framework-versioner: En WebHeaderCollection-instans som returneras av egenskapen Headers genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET Core-versioner via version 3.1: En WebHeaderCollection-instans som används med någon rubrik av typen HttpResponseHeader genererar en ArgumentOutOfRangeException om längden på
valueär större än 65535. Alla andra WebHeaderCollection instanser accepterar envaluelängd. - På .NET 5 och senare versioner: WebHeaderCollection accepterar en
valueoavsett längd.
Kommentarer
Om rubriken som anges i name inte finns Add infogar metoden en ny rubrik i listan med rubriknamn/värdepar.
Om rubriken som anges i name redan value finns läggs den till i den befintliga kommaavgränsade listan med värden som är associerade med name.