WebHeaderCollection.Set Metod

Definition

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.

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.

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.

name är en begränsad rubrik.

-eller-

name eller value innehåller ogiltiga tecken.

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.

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.

Gäller för