WebHeaderCollection.Add Methode

Definition

Namespace:: System.Net

Assemblys:: netstandard.dll, System.Net.WebHeaderCollection.dll

Assembly:: System.Net.WebHeaderCollection.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt eine neue Kopfzeile in die Auflistung ein.

Überlädt

Name	Beschreibung
Add(String)	Fügt die angegebene Kopfzeile in die Auflistung ein.
Add(HttpRequestHeader, String)	Fügt die angegebene Kopfzeile mit dem angegebenen Wert in die Auflistung ein.
Add(HttpResponseHeader, String)	Fügt die angegebene Kopfzeile mit dem angegebenen Wert in die Auflistung ein.
Add(String, String)	Fügt eine Kopfzeile mit dem angegebenen Namen und Wert in die Auflistung ein.

Add(String)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Fügt die angegebene Kopfzeile in die Auflistung ein.

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

public void Add(string header);

override this.Add : string -> unit

Public Sub Add (header As String)

Parameter

header: String

Die hinzuzufügende Kopfzeile, wobei der Name und der Wert durch einen Doppelpunkt getrennt sind.

Ausnahmen

ArgumentNullException

header ist null oder Empty.

ArgumentException

header enthält keinen Doppelpunkt (:) Zeichen).

- oder -

Die Länge des Wertteils ist header größer als 65535.

- oder -

Der Nameteil header ist Empty oder enthält ungültige Zeichen.

- oder -

header ist ein eingeschränkter Header, der mit einer Eigenschaft festgelegt werden soll.

- oder -

Der Wertteil enthält header ungültige Zeichen.

ArgumentOutOfRangeException

.NET Framework und .NET Core, Version 2.0 - 3.1: Die Länge der Zeichenfolge nach dem Doppelpunkt (:) ist größer als 65535.

Beispiele

Im folgenden Beispiel wird einer WebHeaderCollection using-Methode Add ein Name/Wert-Paar hinzugefügt.

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

Hinweis

Die Länge des Wertteils von header, d. h. die Zeichenfolge nach dem Doppelpunkt (:), wird nur in .NET Framework und .NET Core-Versionen 2.0 - 3.1 überprüft.

Bei allen anwendbaren .NET Framework-Versionen wird eine WebHeaderCollection Instanz ausgelöstArgumentOutOfRangeException, die von der Headers Eigenschaft zurückgegeben wird, wenn die Länge des Wertteilsheader größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren einen Wert beliebiger Länge.
In .NET Core-Versionen bis Version 3.1: Eine WebHeaderCollection Instanz, die mit einem beliebigen Header des Typs HttpResponseHeader verwendet wird, löst eine ArgumentOutOfRangeException , wenn die Länge des Wertteilsheader größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren einen Wert beliebiger Länge.
In .NET 5 und höheren Versionen: WebHeaderCollection akzeptiert einen Wert beliebiger Länge.

Hinweise

Der header Parameter muss im Format "name:value" angegeben werden. Wenn die angegebene Kopfzeile in der Auflistung nicht vorhanden ist, wird der Auflistung eine neue Kopfzeile hinzugefügt.

Wenn die angegebene header Kopfzeile bereits in der Auflistung vorhanden ist, wird der Wertteil des header Objekts mit dem vorhandenen Wert verkettet.

Gilt für:

Add(HttpRequestHeader, String)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Fügt die angegebene Kopfzeile mit dem angegebenen Wert in die Auflistung ein.

public:
 void Add(System::Net::HttpRequestHeader header, System::String ^ value);

public void Add(System.Net.HttpRequestHeader header, 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)

Parameter

header: HttpRequestHeader

Die Kopfzeile, die der Auflistung hinzugefügt werden soll.

value: String

Der Inhalt der Kopfzeile.

Ausnahmen

ArgumentOutOfRangeException

.NET Framework und .NET Core, Version 2.0 – 3.1: Die Länge value ist größer als 65535.

InvalidOperationException

Diese WebHeaderCollection Instanz lässt keine Instanzen von HttpRequestHeader.

Hinweise

Wenn die angegebene Kopfzeile nicht vorhanden ist, fügt die Add Methode eine neue Kopfzeile in die Liste der Kopfzeilennamen-Wert-Paare ein.

Wenn der angegebene Header bereits vorhanden ist, wird der kommagetrennten Liste der werte hinzugefügt, value die der Kopfzeile zugeordnet sind.

Hinweis

Die Länge wird value nur in .NET Framework- und .NET Core-Versionen 2.0 - 3.1 überprüft.

Bei allen anwendbaren .NET Framework-Versionen wird eine WebHeaderCollection Instanz ausgelöstArgumentOutOfRangeException, die von der Headers Eigenschaft zurückgegeben wird, wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET Core-Versionen bis Version 3.1: Eine WebHeaderCollection Instanz, die mit einem beliebigen Header des Typs HttpResponseHeader verwendet wird, löst eine ArgumentOutOfRangeException , wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET 5 und höheren Versionen: WebHeaderCollection akzeptiert eine value beliebige Länge.

Gilt für:

Add(HttpResponseHeader, String)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Fügt die angegebene Kopfzeile mit dem angegebenen Wert in die Auflistung ein.

public:
 void Add(System::Net::HttpResponseHeader header, System::String ^ value);

public void Add(System.Net.HttpResponseHeader header, 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)

Parameter

header: HttpResponseHeader

Die Kopfzeile, die der Auflistung hinzugefügt werden soll.

value: String

Der Inhalt der Kopfzeile.

Ausnahmen

ArgumentOutOfRangeException

.NET Framework und .NET Core, Version 2.0 – 3.1: Die Länge value ist größer als 65535.

InvalidOperationException

Diese WebHeaderCollection Instanz lässt keine Instanzen von HttpResponseHeader.

Hinweise

Wenn die angegebene Kopfzeile nicht vorhanden ist, fügt die Add Methode eine neue Kopfzeile in die Liste der Kopfzeilennamen-Wert-Paare ein.

Wenn der angegebene Header bereits vorhanden ist, wird der kommagetrennten Liste der werte hinzugefügt, value die der Kopfzeile zugeordnet sind.

Hinweis

Die Länge wird value nur in .NET Framework- und .NET Core-Versionen 2.0 - 3.1 überprüft.

Bei allen anwendbaren .NET Framework-Versionen wird eine WebHeaderCollection Instanz ausgelöstArgumentOutOfRangeException, die von der Headers Eigenschaft zurückgegeben wird, wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET Core-Versionen bis Version 3.1: Eine WebHeaderCollection Instanz, die mit einem beliebigen Header des Typs HttpResponseHeader verwendet wird, löst eine ArgumentOutOfRangeException , wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET 5 und höheren Versionen: WebHeaderCollection akzeptiert eine value beliebige Länge.

Gilt für:

Add(String, String)

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Quelle:: WebHeaderCollection.cs

Fügt eine Kopfzeile mit dem angegebenen Namen und Wert in die Auflistung ein.

public:
 override void Add(System::String ^ name, System::String ^ value);

public override void Add(string name, 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)

Parameter

name: String

Die Kopfzeile, die der Auflistung hinzugefügt werden soll.

value: String

Der Inhalt der Kopfzeile.

Ausnahmen

ArgumentException

name ist null, Emptyoder enthält ungültige Zeichen.

- oder -

name ist ein eingeschränkter Header, der mit einer Eigenschaftseinstellung festgelegt werden muss.

- oder -

value enthält ungültige Zeichen.

ArgumentOutOfRangeException

.NET Framework und .NET Core, Version 2.0 – 3.1: Die Länge value ist größer als 65535.

Beispiele

Im folgenden Beispiel wird einer WebHeaderCollection using-Methode Add ein Name/Wert-Paar hinzugefügt.

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

Hinweis

Die Länge wird value nur in .NET Framework- und .NET Core-Versionen 2.0 - 3.1 überprüft.

Bei allen anwendbaren .NET Framework-Versionen wird eine WebHeaderCollection Instanz ausgelöstArgumentOutOfRangeException, die von der Headers Eigenschaft zurückgegeben wird, wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET Core-Versionen bis Version 3.1: Eine WebHeaderCollection Instanz, die mit einem beliebigen Header des Typs HttpResponseHeader verwendet wird, löst eine ArgumentOutOfRangeException , wenn die Länge value größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine value beliebige Länge.
In .NET 5 und höheren Versionen: WebHeaderCollection akzeptiert eine value beliebige Länge.

Hinweise

Wenn die angegebene name Kopfzeile nicht vorhanden ist, fügt die Add Methode eine neue Kopfzeile in die Liste der Kopfzeilennamen-Wert-Paare ein.

Wenn die angegebene name Kopfzeile bereits vorhanden ist, value wird sie der vorhandenen durch Trennzeichen getrennten Liste der werte hinzugefügt, die namezugeordnet sind.

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

WebHeaderCollection.Add Methode

Definition

Überlädt

Add(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(HttpRequestHeader, String)

Parameter

Ausnahmen

Hinweise

Gilt für:

Add(HttpResponseHeader, String)

Parameter

Ausnahmen

Hinweise

Gilt für:

Add(String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback