HttpWebRequest.Host Свойство

Определение

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

System.Net

Сборка:

System.Net.Requests.dll

Сборка:

System.dll

Сборка:

netstandard.dll

Получает или задает значение заголовка Host для использования в HTTP-запросе независимо от URI запроса.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

Значение свойства

String

Значение заголовка Host в HTTP-запросе.

Исключения

ArgumentNullException

Заголовок узла не может иметь значение null.

ArgumentException

Заголовку узла не может задано недопустимое значение.

InvalidOperationException

Нельзя установить заголовок узла после начала отправки HttpWebRequest.

Комментарии

Это Host свойство можно использовать для задания значения заголовка узла для использования в HTTP-запросе независимо от универсального кода ресурса (URI) запроса. Свойство Host может состоять из имени узла и необязательного номера порта. Заголовок узла без сведений о порте подразумевает порт по умолчанию для запрошенной службы (например, порт 80 для URL-адреса HTTP).

Формат указания узла и порта должен соответствовать правилам в разделе 14.23 RFC2616, опубликованном IETF. Пример соответствия этим требованиям, указывающий порт 8080, будет следующим значением Host для свойства:

www.contoso.com:8080

Host Использование свойства для явного указания настраиваемого значения заголовка узла также влияет на кэширование областей, файлы cookie и проверку подлинности. Когда приложение предоставляет учетные данные для определенного префикса URI, приложения должны использовать универсальный код ресурса (URI), содержащий значение заголовка узла, а не целевой сервер в URI. Ключ, используемый при кэшировании ресурсов, использует значение заголовка узла, а не URI запроса. Файлы cookie хранятся в и CookieContainer логически сгруппированы по доменному имени сервера. Если приложение задает заголовок узла, это значение будет использоваться в качестве домена.

Host Если свойство не задано, значение заголовка узла, используемое в HTTP-запросе, основано на универсальном коде ресурса (URI) запроса.