WebHeaderCollection.Add Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebHeaderCollection.dll

Vloží do kolekce nové záhlaví.

Přetížení

Name	Description
Add(String)	Vloží zadanou hlavičku do kolekce.
Add(HttpRequestHeader, String)	Vloží zadanou hlavičku se zadanou hodnotou do kolekce.
Add(HttpResponseHeader, String)	Vloží zadanou hlavičku se zadanou hodnotou do kolekce.
Add(String, String)	Vloží záhlaví se zadaným názvem a hodnotou do kolekce.

Add(String)

Zdroj:

WebHeaderCollection.cs

Vloží zadanou hlavičku do kolekce.

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

public void Add(string header);

override this.Add : string -> unit

Public Sub Add (header As String)

Parametry

header

String

Záhlaví, které chcete přidat, s názvem a hodnotou oddělenou dvojtečku.

Výjimky

ArgumentNullException

header je null nebo Empty.

ArgumentException

header neobsahuje dvojtečku (:) znak.

nebo

Délka části header hodnoty je větší než 65535.

nebo

Část názvu header je Empty nebo obsahuje neplatné znaky.

nebo

header je omezená hlavička, která by měla být nastavena s vlastností.

nebo

Hodnota části header obsahuje neplatné znaky.

ArgumentOutOfRangeException

.NET Framework a .NET Core verze 2.0 – 3.1: Délka řetězce za dvojtečku (:) je větší než 65535.

Příklady

Následující příklad přidá dvojici name/value do WebHeaderCollection metody.Add

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

Poznámka:

Délka částiheaderhodnoty , tj. řetězec za dvojtečku (:), je ověřen pouze v rozhraní .NET Framework a .NET Core verze 2.0 – 3.1.

• U všech použitelných verzí rozhraní .NET Framework: WebHeaderCollection Instance vrácená Headers vlastností vyvolá ArgumentOutOfRangeException , pokud je délka částiheader hodnoty větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají hodnotu jakékoli délky.
• Verze .NET Core až verze 3.1: Instance WebHeaderCollection použitá s libovolnou hlavičkou typu HttpResponseHeader vyvolá ArgumentOutOfRangeException , pokud je délka hodnotyheader větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají hodnotu jakékoli délky.
• V .NET 5 a novějších verzích: WebHeaderCollection přijímá hodnotu libovolné délky.

Poznámky

Parametr header musí být zadán ve formátu name:value. Pokud zadaná hlavička v kolekci neexistuje, přidá se do kolekce nová hlavička.

Pokud je hlavička zadaná v header kolekci již přítomna, je část header hodnoty zřetězena s existující hodnotou.

Add(HttpRequestHeader, String)

Zdroj:

WebHeaderCollection.cs

Vloží zadanou hlavičku se zadanou hodnotou do kolekce.

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)

Parametry

header

HttpRequestHeader

Záhlaví, které chcete přidat do kolekce.

value

String

Obsah záhlaví.

Výjimky

ArgumentOutOfRangeException

Pouze rozhraní .NET Framework a .NET Core verze 2.0 – 3.1: Délka value je větší než 65535.

InvalidOperationException

Tato WebHeaderCollection instance nepovoluje instance .HttpRequestHeader

Poznámky

Pokud zadaná hlavička neexistuje, Add metoda vloží nové záhlaví do seznamu dvojic název/hodnota záhlaví.

Pokud je zadaná hlavička již k dispozici, value přidá se do seznamu hodnot oddělených čárkami přidružených k záhlaví.

Poznámka:

Délka value se ověřuje pouze v rozhraní .NET Framework a .NET Core verze 2.0 – 3.1.

• U všech použitelných verzí rozhraní .NET Framework: Instance WebHeaderCollection vrácená Headers vlastností vyvolá ArgumentOutOfRangeException výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• Ve verzích .NET Core až verze 3.1: Instance WebHeaderCollection použitá s libovolnou ArgumentOutOfRangeException hlavičkou typu HttpResponseHeader vyvolá výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• V .NET 5 a novějších verzích: WebHeaderCollection přijímá libovolnou délku value .

Add(HttpResponseHeader, String)

Zdroj:

WebHeaderCollection.cs

Vloží zadanou hlavičku se zadanou hodnotou do kolekce.

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)

Parametry

header

HttpResponseHeader

Záhlaví, které chcete přidat do kolekce.

value

String

Obsah záhlaví.

Výjimky

ArgumentOutOfRangeException

Pouze rozhraní .NET Framework a .NET Core verze 2.0 – 3.1: Délka value je větší než 65535.

InvalidOperationException

Tato WebHeaderCollection instance nepovoluje instance .HttpResponseHeader

Poznámky

Pokud zadaná hlavička neexistuje, Add metoda vloží nové záhlaví do seznamu dvojic název/hodnota záhlaví.

Pokud je zadaná hlavička již k dispozici, value přidá se do seznamu hodnot oddělených čárkami přidružených k záhlaví.

Poznámka:

Délka value se ověřuje pouze v rozhraní .NET Framework a .NET Core verze 2.0 – 3.1.

• U všech použitelných verzí rozhraní .NET Framework: Instance WebHeaderCollection vrácená Headers vlastností vyvolá ArgumentOutOfRangeException výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• Ve verzích .NET Core až verze 3.1: Instance WebHeaderCollection použitá s libovolnou ArgumentOutOfRangeException hlavičkou typu HttpResponseHeader vyvolá výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• V .NET 5 a novějších verzích: WebHeaderCollection přijímá libovolnou délku value .

Add(String, String)

Zdroj:

WebHeaderCollection.cs

Vloží záhlaví se zadaným názvem a hodnotou do kolekce.

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)

Parametry

name

String

Záhlaví, které chcete přidat do kolekce.

value

String

Obsah záhlaví.

Výjimky

ArgumentException

name je null, Emptynebo obsahuje neplatné znaky.

nebo

name je omezená hlavička, která musí být nastavena nastavením vlastnosti.

nebo

value obsahuje neplatné znaky.

ArgumentOutOfRangeException

Pouze rozhraní .NET Framework a .NET Core verze 2.0 – 3.1: Délka value je větší než 65535.

Příklady

Následující příklad přidá dvojici name/value do WebHeaderCollection metody.Add

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

Poznámka:

Délka value se ověřuje pouze v rozhraní .NET Framework a .NET Core verze 2.0 – 3.1.

• U všech použitelných verzí rozhraní .NET Framework: Instance WebHeaderCollection vrácená Headers vlastností vyvolá ArgumentOutOfRangeException výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• Ve verzích .NET Core až verze 3.1: Instance WebHeaderCollection použitá s libovolnou ArgumentOutOfRangeException hlavičkou typu HttpResponseHeader vyvolá výjimku, pokud je délka value větší než 65535. Všechny ostatní WebHeaderCollection instance přijímají libovolnou délku value .
• V .NET 5 a novějších verzích: WebHeaderCollection přijímá libovolnou délku value .

Poznámky

Pokud záhlaví zadané v name neexistuje, Add metoda vloží nové záhlaví do seznamu párů název/hodnota záhlaví.

Pokud je hlavička zadaná name v seznamu již přítomna, value přidá se do existujícího seznamu hodnot oddělených čárkami přidružených namek .