WebHeaderCollection.Add Metod

Definition

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.

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.

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.

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.

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.

Gäller för