WebHeaderCollection.Add Methode

Definitie

Naamruimte:: System.Net

Assembly:: System.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee voegt u een nieuwe koptekst in de verzameling in.

Overloads

Name	Description
Add(String)	Hiermee voegt u de opgegeven header in de verzameling in.
Add(HttpRequestHeader, String)	Hiermee voegt u de opgegeven header met de opgegeven waarde in de verzameling in.
Add(HttpResponseHeader, String)	Hiermee voegt u de opgegeven header met de opgegeven waarde in de verzameling in.
Add(String, String)	Hiermee voegt u een koptekst met de opgegeven naam en waarde in de verzameling in.

Add(String)

Hiermee voegt u de opgegeven header in de verzameling in.

public:
 void Add(System::String ^ header);

public void Add(string header);

override this.Add : string -> unit

Public Sub Add (header As String)

Parameters

header: String

De koptekst die moet worden toegevoegd, met de naam en waarde gescheiden door een dubbele punt.

Uitzonderingen

ArgumentNullException

header is null of Empty.

ArgumentException

header bevat geen dubbele punt (:) teken.

– of –

De lengte van het waardegedeelte header is groter dan 65535.

– of –

Het naamgedeelte header is Empty of bevat ongeldige tekens.

– of –

header is een beperkte header die moet worden ingesteld met een eigenschap.

– of –

Het waardegedeelte bevat header ongeldige tekens.

ArgumentOutOfRangeException

.NET Framework en .NET Core-versies 2.0 - 3.1 alleen: de lengte van de tekenreeks na de dubbele punt (:) groter is dan 65535.

Voorbeelden

In het volgende voorbeeld wordt een naam/waardepaar aan een WebHeaderCollection met behulp van de Add methode toegevoegd.

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

De lengte van het waarde gedeelte van header, dat wil gezegd, de tekenreeks na de dubbele punt (:), wordt alleen gevalideerd in .NET Framework en .NET Core-versies 2.0 - 3.1.

Op alle toepasselijke .NET Framework-versies: Een WebHeaderCollection exemplaar dat wordt geretourneerd door de eigenschap Headers genereert een ArgumentOutOfRangeException als de lengte van de waarde gedeelte van header groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een waarde van elke lengte.
Op .NET Core-versies tot en met versie 3.1: Een WebHeaderCollection exemplaar dat wordt gebruikt met een header van het type HttpResponseHeader genereert een ArgumentOutOfRangeException als de lengte van de waarde gedeelte van header groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een waarde van elke lengte.
Op .NET 5 en hoger: WebHeaderCollection accepteert een waarde van elke lengte.

Opmerkingen

De header parameter moet worden opgegeven in de notatie 'name:value'. Als de opgegeven header niet bestaat in de verzameling, wordt er een nieuwe header toegevoegd aan de verzameling.

Als de opgegeven header header al aanwezig is in de verzameling, wordt het waardegedeelte van de header verzameling samengevoegd met de bestaande waarde.

Van toepassing op

Add(HttpRequestHeader, String)

Hiermee voegt u de opgegeven header met de opgegeven waarde in de verzameling in.

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)

Parameters

header: HttpRequestHeader

De header die moet worden toegevoegd aan de verzameling.

value: String

De inhoud van de koptekst.

Uitzonderingen

ArgumentOutOfRangeException

.NET Framework en .NET Core-versies 2.0 - 3.1: De lengte van value is groter dan 65535.

InvalidOperationException

Dit WebHeaderCollection exemplaar staat geen exemplaren van HttpRequestHeader.

Opmerkingen

Als de opgegeven header niet bestaat, wordt met de Add methode een nieuwe header ingevoegd in de lijst met headernaam-/waardeparen.

Als de opgegeven koptekst al aanwezig is, value wordt deze toegevoegd aan de door komma's gescheiden lijst met waarden die zijn gekoppeld aan de koptekst.

Note

De lengte van value wordt alleen gevalideerd in .NET Framework en .NET Core-versies 2.0 - 3.1.

Op alle toepasselijke .NET Framework-versies: Een WebHeaderCollection exemplaar dat wordt geretourneerd door de eigenschap Headers genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET Core-versies tot en met versie 3.1: Een WebHeaderCollection exemplaar dat wordt gebruikt met een header van het type HttpResponseHeader genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET 5 en latere versies: WebHeaderCollection accepteert een value van elke lengte.

Van toepassing op

Add(HttpResponseHeader, String)

Hiermee voegt u de opgegeven header met de opgegeven waarde in de verzameling in.

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)

Parameters

header: HttpResponseHeader

De header die moet worden toegevoegd aan de verzameling.

value: String

De inhoud van de koptekst.

Uitzonderingen

ArgumentOutOfRangeException

.NET Framework en .NET Core-versies 2.0 - 3.1: De lengte van value is groter dan 65535.

InvalidOperationException

Dit WebHeaderCollection exemplaar staat geen exemplaren van HttpResponseHeader.

Opmerkingen

Als de opgegeven header niet bestaat, wordt met de Add methode een nieuwe header ingevoegd in de lijst met headernaam-/waardeparen.

Als de opgegeven koptekst al aanwezig is, value wordt deze toegevoegd aan de door komma's gescheiden lijst met waarden die zijn gekoppeld aan de koptekst.

Note

De lengte van value wordt alleen gevalideerd in .NET Framework en .NET Core-versies 2.0 - 3.1.

Op alle toepasselijke .NET Framework-versies: Een WebHeaderCollection exemplaar dat wordt geretourneerd door de eigenschap Headers genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET Core-versies tot en met versie 3.1: Een WebHeaderCollection exemplaar dat wordt gebruikt met een header van het type HttpResponseHeader genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET 5 en latere versies: WebHeaderCollection accepteert een value van elke lengte.

Van toepassing op

Add(String, String)

Hiermee voegt u een koptekst met de opgegeven naam en waarde in de verzameling in.

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)

Parameters

name: String

De header die moet worden toegevoegd aan de verzameling.

value: String

De inhoud van de koptekst.

Uitzonderingen

ArgumentException

name is null, Emptyof bevat ongeldige tekens.

– of –

name is een beperkte header die moet worden ingesteld met een eigenschapsinstelling.

– of –

value bevat ongeldige tekens.

ArgumentOutOfRangeException

.NET Framework en .NET Core-versies 2.0 - 3.1: De lengte van value is groter dan 65535.

Voorbeelden

In het volgende voorbeeld wordt een naam/waardepaar aan een WebHeaderCollection met behulp van de Add methode toegevoegd.

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

De lengte van value wordt alleen gevalideerd in .NET Framework en .NET Core-versies 2.0 - 3.1.

Op alle toepasselijke .NET Framework-versies: Een WebHeaderCollection exemplaar dat wordt geretourneerd door de eigenschap Headers genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET Core-versies tot en met versie 3.1: Een WebHeaderCollection exemplaar dat wordt gebruikt met een header van het type HttpResponseHeader genereert een ArgumentOutOfRangeException als de lengte van value groter is dan 65535. Alle andere WebHeaderCollection exemplaren accepteren een value lengte.
Op .NET 5 en latere versies: WebHeaderCollection accepteert een value van elke lengte.

Opmerkingen

Als de opgegeven name header niet bestaat, wordt met de Add methode een nieuwe header ingevoegd in de lijst met headernaam-/waardeparen.

Als de opgegeven name header al aanwezig is, value wordt deze toegevoegd aan de bestaande door komma's gescheiden lijst met waarden die zijn gekoppeld aan name.

Van toepassing op

Feedback

Is deze pagina nuttig?