HttpHeaders.Add Метод

Определение

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

System.Net.Http.Headers

Сборка:

System.Net.Http.dll

Вставляет новый заголовок и его значения в коллекцию HttpHeaders.

Перегрузки

Add(String, IEnumerable<String>)	Добавляет указанный заголовок и его значения в коллекцию HttpHeaders.
Add(String, String)	Добавляет указанный заголовок и его значение в коллекцию HttpHeaders.

Add(String, IEnumerable<String>)

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

HttpHeaders.cs

Добавляет указанный заголовок и его значения в коллекцию HttpHeaders.

public:
 void Add(System::String ^ name, System::Collections::Generic::IEnumerable<System::String ^> ^ values);

public void Add (string name, System.Collections.Generic.IEnumerable<string?> values);

member this.Add : string * seq<string> -> unit

Public Sub Add (name As String, values As IEnumerable(Of String))

Параметры

name

String

Заголовок для добавления в коллекцию.

values

IEnumerable<String>

Список значений заголовков для добавления в коллекцию.

Исключения

ArgumentException

Имя не может быть равным NULL или пустым.

ArgumentNullException

Значения не могут быть равными NULL или пустыми.

InvalidOperationException

Неправильно используемое имя заголовка. Убедитесь, что заголовки запросов используются с HttpRequestMessage, заголовки ответов — с HttpResponseMessage, а заголовки содержимого —с объектами HttpContent.

FormatException

Формат имени заголовка недопустим.

-или-

После символов новой строки в значениях заголовков должен стоять пробел.

Комментарии

Заголовок values будет проанализирован и проверен.

Если указанный заголовок не существует, Add метод вставляет новый заголовок в список пар имя-значение заголовка.

Если указанный заголовок уже присутствует, добавляются в разделенный запятыми список значений, values связанных с заголовком.

Add(String, String)

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

HttpHeaders.cs

Добавляет указанный заголовок и его значение в коллекцию HttpHeaders.

public:
 void Add(System::String ^ name, System::String ^ value);

public void Add (string name, string? value);

member this.Add : string * string -> unit

Public Sub Add (name As String, value As String)

Параметры

name

String

Заголовок для добавления в коллекцию.

value

String

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

Исключения

ArgumentException

Имя не может быть равным NULL или пустым.

InvalidOperationException

Неправильно используемое имя заголовка. Убедитесь, что заголовки запросов используются с HttpRequestMessage, заголовки ответов — с HttpResponseMessage, а заголовки содержимого —с объектами HttpContent.

FormatException

Формат имени заголовка недопустим.

-или-

После символов новой строки в значениях заголовков должен стоять пробел.

Комментарии

Заголовок value будет проанализирован и проверен.

Если указанный заголовок не существует, Add метод вставляет новый заголовок в список пар имя-значение заголовка.

Если указанный заголовок уже присутствует, добавляется в разделенный запятыми список значений, value связанных с заголовком.