HttpWebRequest.Host Właściwość

Definicja

Pobiera lub ustawia wartość nagłówka hosta, która będzie używana w żądaniu HTTP niezależnym od identyfikatora URI żądania.Gets or sets the Host header value to use in an HTTP request independent from the request URI.

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.The Host header value in the HTTP request.

Wyjątki

Nie można ustawić nullw nagłówku hosta.The Host header cannot be set to null.

Dla nagłówka hosta nie można ustawić nieprawidłowej wartości.The Host header cannot be set to an invalid value.

Nie można ustawić nagłówka hosta po rozpoczęciu wysyłania HttpWebRequest.The Host header cannot be set after the HttpWebRequest has already started to be sent.

Uwagi

Właściwość Host może służyć do ustawiania wartości nagłówka hosta do użycia w żądaniu HTTP niezależnym od identyfikatora URI żądania.The Host property can be used to set the Host header value to use in an HTTP request independent from the request URI. Właściwość Host może składać się z nazwy hosta i opcjonalnego numeru portu.The Host property can consist of a hostname and an optional port number. Nagłówek hosta bez informacji o porcie oznacza domyślny port dla żądanej usługi (na przykład port 80 dla adresu URL HTTP).A Host header without port information implies the default port for the service requested (port 80 for an HTTP URL, for example).

Format służący do określania hosta i portu musi być zgodny z regułami w sekcji 14,23 RFC2616 publikowanych przez grupę IETF.The format for specifying a host and port must follow the rules in section 14.23 of RFC2616 published by the IETF. Przykład spełniający wymagania, które określają port 8080, będzie następująca wartość dla właściwości Host:An example complying with these requirements that specifies a port of 8080 would be the following value for the Host property:

www.contoso.com:8080

Użycie właściwości Host w celu jawnego określenia wartości niestandardowego nagłówka hosta wpływa również na buforowanie obszarów, plików cookie i uwierzytelniania.Using the Host property to explicitly specify a custom Host header value also affects areas caching, cookies, and authentication. Gdy aplikacja dostarcza poświadczenia dla określonego prefiksu identyfikatora URI, aplikacje muszą upewnić się, że użyto identyfikatora URI zawierającego wartość nagłówka hosta, a nie serwera docelowego w identyfikatorze URI.When an application provides credentials for a specific URI prefix, the applications needs to make sure to use the URI containing the value of the Host header, not the target server in the URI. Klucz używany podczas buforowania zasobów przy użyciu wartości nagłówka hosta, a nie identyfikatora URI żądania.The key used when caching resources, uses the Host header value rather than the request URI. Pliki cookie są przechowywane w CookieContainer i logicznie pogrupowane według nazwy domeny serwera.Cookies are stored in a CookieContainer and logically grouped by the server domain name. Jeśli aplikacja określa nagłówek hosta, ta wartość zostanie użyta jako domena.If the application specifies a Host header, then this value will be used as domain.

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.If the Host property is not set, then the Host header value to use in an HTTP request is based on the request URI.

Dotyczy