WebHeaderCollection.AddWithoutValidate(String, String) Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

netstandard.dll, System.Net.WebHeaderCollection.dll

Origine:

WebHeaderCollection.cs

Inserisce un'intestazione nella raccolta senza verificare se l'intestazione si trova nell'elenco di intestazioni con restrizioni.

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)

Parametri

headerName

String

Intestazione da aggiungere alla raccolta.

headerValue

String

Contenuto dell'intestazione.

Eccezioni

ArgumentException

headerName è null, Emptyo contiene caratteri non validi.

oppure

headerValue contiene caratteri non validi.

ArgumentOutOfRangeException

Solo .NET Framework e .NET Core: headerName non null è e la lunghezza di headerValue è troppo lunga (maggiore di 65.535 caratteri).

Commenti

Il AddWithoutValidate metodo aggiunge un'intestazione alla raccolta senza verificare se l'intestazione si trova nell'elenco di intestazioni con restrizioni.

Annotazioni

La lunghezza di headerValue viene convalidata solo in .NET Framework e .NET Core versioni 2.0 - 3.1.

• In tutte le versioni di .NET Framework applicabili: un'istanza WebHeaderCollection restituita dalla Headers proprietà genererà un'eccezione ArgumentOutOfRangeException se la lunghezza di è maggiore di headerValue 65535. Tutte le altre WebHeaderCollection istanze accettano una headerValue qualsiasi lunghezza.
• Nelle versioni di .NET Core fino alla versione 3.1: un'istanza WebHeaderCollection usata con qualsiasi intestazione di tipo HttpResponseHeader genererà un'eccezione ArgumentOutOfRangeException se la lunghezza di è maggiore di headerValue 65535. Tutte le altre WebHeaderCollection istanze accettano una headerValue qualsiasi lunghezza.
• In .NET 5 e versioni successive: WebHeaderCollection accetta una headerValue qualsiasi lunghezza.

Note per gli eredi

Utilizzare il AddWithoutValidate(String, String) metodo per aggiungere intestazioni normalmente esposte tramite proprietà.