WebHeaderCollection.AddWithoutValidate(String, String) Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebHeaderCollection.dll

Quelle:

WebHeaderCollection.cs

Fügt einen Header in die Auflistung ein, ohne zu überprüfen, ob der Header in der Liste der eingeschränkten Header aufgeführt wird.

protected:
 void AddWithoutValidate(System::String ^ headerName, System::String ^ headerValue);

protected void AddWithoutValidate (string headerName, string? headerValue);

member this.AddWithoutValidate : string * string -> unit

Protected Sub AddWithoutValidate (headerName As String, headerValue As String)

Parameter

headerName

String

Der Header, der der Auflistung hinzugefügt werden soll.

headerValue

String

Der Inhalt des Headers.

Ausnahmen

ArgumentException

headerName ist null, Empty oder enthält ungültige Zeichen.

- oder -

headerValue enthält ungültige Zeichen.

ArgumentOutOfRangeException

Nur .NET Framework und .NET Core: headerName ist nicht null, und headerValue ist zu lang (über 65.535 Zeichen).

Hinweise

Die AddWithoutValidate -Methode fügt der Auflistung einen Header hinzu, ohne zu überprüfen, ob sich der Header in der Eingeschränkten Headerliste befindet.

Hinweis

Die Länge von headerValue wird nur in den .NET Framework- und .NET Core-Versionen 2.0 bis 3.1 überprüft.

• Für alle anwendbaren .NET Framework-Versionen: Eine WebHeaderCollection Von der Headers -Eigenschaft zurückgegebene Instanz löst einen aus ArgumentOutOfRangeException , wenn die Länge von headerValue größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine headerValue 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 aus ArgumentOutOfRangeException , wenn die Länge von headerValue größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine headerValue beliebige Länge.
• Unter .NET 5 und höheren Versionen: WebHeaderCollection akzeptiert eine headerValue beliebige Länge.

Hinweise für Vererber

Verwenden Sie die AddWithoutValidate(String, String) -Methode, um Header hinzuzufügen, die normalerweise über Eigenschaften verfügbar gemacht werden.