WebHeaderCollection.AddWithoutValidate(String, String) Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.WebHeaderCollection.dll

Исходный код:

WebHeaderCollection.cs

Вставляет заголовок в коллекцию без проверки того, находится ли заголовок в списке ограниченных заголовков.

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)

Параметры

headerName

String

Заголовок, добавляемый в коллекцию.

headerValue

String

Содержимое заголовка.

Исключения

ArgumentException

headerName имеет nullзначение , Emptyили содержит недопустимые символы.

–или–

headerValue содержит недопустимые символы.

ArgumentOutOfRangeException

Только .NET Framework и .NET Core: headerName не null является и длина headerValue слишком длинна (больше 65 535 символов).

Комментарии

Метод AddWithoutValidate добавляет заголовок в коллекцию без проверки того, находится ли заголовок в списке ограниченных заголовков.

Замечание

Длина headerValue проверяется только в .NET Framework и .NET Core версии 2.0 – 3.1.

• Во всех применимых версиях .NET Framework: экземпляр, возвращаемый Headers свойством, WebHeaderCollection вызывает ArgumentOutOfRangeException исключение, если длина headerValue превышает 65535. Все остальные WebHeaderCollection экземпляры принимают headerValue любую длину.
• В версиях .NET Core до версии 3.1: WebHeaderCollection экземпляр, используемый с любым заголовком типа HttpResponseHeader , создает ArgumentOutOfRangeException исключение, если длина headerValue превышает 65535. Все остальные WebHeaderCollection экземпляры принимают headerValue любую длину.
• В .NET 5 и более поздних версиях: WebHeaderCollection принимает любую длину headerValue .

Примечания для тех, кто наследует этот метод

AddWithoutValidate(String, String) Используйте метод для добавления заголовков, которые обычно предоставляются с помощью свойств.