HttpWebRequest.Host Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.Requests.dll

Źródło:

HttpWebRequest.cs

Pobiera lub ustawia wartość nagłówka hosta do użycia w żądaniu HTTP niezależnie od identyfikatora URI żądania.

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

Wartość właściwości

String

Wartość nagłówka hosta w żądaniu HTTP.

Wyjątki

ArgumentNullException

Nie można ustawić nagłówka Hosta na nullwartość .

ArgumentException

Nie można ustawić nagłówka hosta na nieprawidłową wartość.

InvalidOperationException

Nie można ustawić nagłówka hosta po rozpoczęciu wysyłania HttpWebRequest .

Uwagi

Ostrożność

WebRequest, , HttpWebRequestServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Użyj HttpClient zamiast tego.

Właściwość Host może służyć do ustawiania wartości nagłówka hosta do użycia w żądaniu HTTP niezależnie od identyfikatora URI żądania żądania. Właściwość Host może składać się z nazwy hosta i opcjonalnego numeru portu. Nagłówek hosta bez informacji o porcie oznacza domyślny port żądanej usługi (na przykład port 80 dla adresu URL HTTP).

Format określania hosta i portu musi być zgodny z regułami w sekcji 14.23 RFC2616 opublikowanej przez IETF. Przykład zgodny z tymi wymaganiami, który określa port 8080, będzie następującą wartością Host dla właściwości:

www.contoso.com:8080

Użycie właściwości do jawnego określenia niestandardowej Host wartości nagłówka hosta wpływa również na buforowanie obszarów, pliki cookie i uwierzytelnianie. Gdy aplikacja udostępnia poświadczenia dla określonego prefiksu identyfikatora URI, aplikacje muszą upewnić się, że używać identyfikatora URI zawierającego wartość nagłówka Hosta, a nie serwera docelowego w identyfikatorze URI. Klucz używany podczas buforowania zasobów używa wartości nagłówka hosta, a nie identyfikatora URI żądania. Pliki cookie są przechowywane w i CookieContainer logicznie pogrupowane według nazwy domeny serwera. Jeśli aplikacja określa nagłówek Hosta, ta wartość będzie używana jako domena.

Host Jeśli właściwość nie jest ustawiona, wartość nagłówka hosta do użycia w żądaniu HTTP jest oparta na identyfikatorze URI żądania żądania.