HttpWebRequest.Host Свойство

Определение

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

System.Net

Сборка:

System.Net.Requests.dll

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

HttpWebRequest.cs

Возвращает или задает значение заголовка узла для использования в 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

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

Исключения

ArgumentNullException

Заголовок узла не может быть задан для null.

ArgumentException

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

InvalidOperationException

Заголовок узла не может быть задан после того, как HttpWebRequest уже запущена отправка.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Свойство 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 запроса.