WebHeaderCollection.AddWithoutValidate(String, String) Methode

Definition

Namespace:

System.Net

Assemblys:

netstandard.dll, System.Net.WebHeaderCollection.dll

Quelle:

WebHeaderCollection.cs

Fügt eine Kopfzeile in die Auflistung ein, ohne zu überprüfen, ob sich die Kopfzeile in der eingeschränkten Kopfzeilenliste befindet.

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

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

headerValue

String

Der Inhalt der Kopfzeile.

Ausnahmen

ArgumentException

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

- oder -

headerValue enthält ungültige Zeichen.

ArgumentOutOfRangeException

.NET Framework und .NET Core: headerName ist nicht null und die Länge ist headerValue zu lang (größer als 65.535 Zeichen).

Hinweise

Die AddWithoutValidate Methode fügt der Auflistung eine Kopfzeile hinzu, ohne zu überprüfen, ob sich die Kopfzeile in der eingeschränkten Kopfzeilenliste befindet.

Hinweis

Die Länge wird headerValue 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 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 ArgumentOutOfRangeException , wenn die Länge headerValue größer als 65535 ist. Alle anderen WebHeaderCollection Instanzen akzeptieren eine headerValue beliebige Länge.
• In .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 Kopfzeilen hinzuzufügen, die normalerweise über Eigenschaften verfügbar gemacht werden.