HttpWebRequest.Host Свойство

Определение

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

System.Net

Сборки:

netstandard.dll, 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 запроса.