HttpWebRequest.Host Свойство

Определение

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

System.Net

Сборка:

System.Net.Requests.dll

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

HttpWebRequest.cs

Получает или задает значение заголовка 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, это значение будет использоваться в качестве домена.

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