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, set
Public Property Host As String
Wartość właściwości
Wartość nagłówka hosta w żądaniu HTTP.
Wyjątki
Nie można ustawić nagłówka hosta na 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
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. 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 dla żą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
Host Użycie właściwości do jawnego określenia niestandardowej wartości nagłówka hosta ma również wpływ 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żyj 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 pliku 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.
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.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla