WebHeaderCollection.AddWithoutValidate(String, String) Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebHeaderCollection.dll

Origine:

WebHeaderCollection.cs

Inserisce nella raccolta un'intestazione, senza verificare se è compresa nell'elenco delle 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, Empty oppure 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 è eccessiva (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.

Nota

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

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

Note per gli eredi

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