HttpWebRequest.Host Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property Host As StringWartość właściwości
Wartość nagłówka hosta w żądaniu HTTP.
Wyjątki
Nie można ustawić nagłówka hosta na wartość null.
Nie można ustawić nagłówka hosta na nieprawidłową wartość.
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.
