WebHeaderCollection.Set 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.
Anger det angivna huvudet till det angivna värdet.
Överlagringar
| Name | Description |
|---|---|
| Set(HttpRequestHeader, String) |
Anger det angivna huvudet till det angivna värdet. |
| Set(HttpResponseHeader, String) |
Anger det angivna huvudet till det angivna värdet. |
| Set(String, String) |
Anger det angivna huvudet till det angivna värdet. |
Set(HttpRequestHeader, String)
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
Anger det angivna huvudet till det angivna värdet.
public:
void Set(System::Net::HttpRequestHeader header, System::String ^ value);
public void Set(System.Net.HttpRequestHeader header, string? value);
public void Set(System.Net.HttpRequestHeader header, string value);
override this.Set : System.Net.HttpRequestHeader * string -> unit
Public Sub Set (header As HttpRequestHeader, value As String)
Parametrar
- header
- HttpRequestHeader
Värdet HttpRequestHeader som ska anges.
- value
- String
Innehållet i rubriken som ska anges.
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 rubriken som anges i rubriken inte finns Set infogar metoden ett nytt huvud i listan över rubriknamn/värdepar.
Om huvudet som anges i header redan finns value ersätter det befintliga värdet.
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
Set(HttpResponseHeader, String)
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
Anger det angivna huvudet till det angivna värdet.
public:
void Set(System::Net::HttpResponseHeader header, System::String ^ value);
public void Set(System.Net.HttpResponseHeader header, string? value);
public void Set(System.Net.HttpResponseHeader header, string value);
override this.Set : System.Net.HttpResponseHeader * string -> unit
Public Sub Set (header As HttpResponseHeader, value As String)
Parametrar
- header
- HttpResponseHeader
Värdet HttpResponseHeader som ska anges.
- value
- String
Innehållet i rubriken som ska anges.
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 rubriken som anges i rubriken inte finns Set infogar metoden ett nytt huvud i listan över rubriknamn/värdepar.
Om huvudet som anges i header redan finns value ersätter det befintliga värdet.
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
Set(String, String)
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
- Källa:
- WebHeaderCollection.cs
Anger det angivna huvudet till det angivna värdet.
public:
override void Set(System::String ^ name, System::String ^ value);
public override void Set(string name, string? value);
public override void Set(string name, string value);
override this.Set : string * string -> unit
Public Overrides Sub Set (name As String, value As String)
Parametrar
- name
- String
Rubriken som ska anges.
- value
- String
Innehållet i rubriken som ska anges.
Undantag
name är null eller Empty.
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 används Set metoden för att ange värdet för ett befintligt huvud.
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;
// Set the Cache-Control header in the request.
myWebHeaderCollection.Set("Cache-Control", "no-cache");
// Get the associated response for the above request.
HttpWebResponse myHttpWebResponse = (HttpWebResponse) myHttpWebRequest.GetResponse();
Console.WriteLine ("Headers after 'Set' method is used on Cache-Control :");
// Print the headers for the request.
PrintHeaders(myWebHeaderCollection);
myHttpWebResponse.Close();
}
// Catch exception if trying to set a restricted header.
catch(ArgumentException e) {
Console.WriteLine("ArgumentException is thrown. Message is :" + e.Message);
}
catch(WebException e) {
Console.WriteLine("WebException is thrown. Message 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
'Set the Cache-Control header in the request.
myWebHeaderCollection.Set("Cache-Control", "no-cache")
'Get the associated response for the above request.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine ("Headers after 'Set' method is used on Cache-Control :")
'Print the headers for the request.
PrintHeaders(myWebHeaderCollection)
myHttpWebResponse.Close()
'Catch exception if trying to set 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 rubriken inte finns Set infogar metoden ett nytt huvud i listan över rubriknamn/värdepar.
Om huvudet som anges i header redan finns value ersätter det befintliga värdet.