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 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

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.