HttpWebRequest.Host Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

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 wartość null.

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, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

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 określający port 8080 będzie następującą wartością właściwości Host:

www.contoso.com:8080

Użycie właściwości Host do jawnego określenia niestandardowej 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 CookieContainer i logicznie pogrupowane według nazwy domeny serwera. Jeśli aplikacja określa nagłówek Hosta, ta wartość będzie używana jako domena.

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