HttpWebRequest.Host Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

HttpWebRequest.cs

Získá nebo nastaví hodnotu hlavičky hostitele použít v požadavku HTTP nezávisle na identifikátoru URI požadavku.

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

Hodnota vlastnosti

String

Hodnota hlavičky hostitele v požadavku HTTP.

Výjimky

ArgumentNullException

Hlavičku Hostitele nelze nastavit na null.

ArgumentException

Hlavičku Hostitele nelze nastavit na neplatnou hodnotu.

InvalidOperationException

Hlavičku Hostitele nelze nastavit po zahájení odesílání HttpWebRequest.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Vlastnost Host lze použít k nastavení hodnoty hlavičky hostitele pro použití v požadavku HTTP nezávisle na identifikátoru URI požadavku. Vlastnost Host se může skládat z názvu hostitele a volitelného čísla portu. Hlavička hostitele bez informací o portu znamená výchozí port požadované služby (například port 80 pro adresu URL PROTOKOLU HTTP).

Formát pro určení hostitele a portu musí odpovídat pravidlu v bodě 14.23 RFC2616 publikovaným nástrojem IETF. Příklad, který vyhovuje těmto požadavkům, který určuje port 8080, by byla následující hodnota pro vlastnost Host:

www.contoso.com:8080

Použití vlastnosti Host k explicitní zadání vlastní hodnoty hlavičky hostitele má vliv také na oblasti ukládání do mezipaměti, soubory cookie a ověřování. Pokud aplikace poskytuje přihlašovací údaje pro konkrétní předponu identifikátoru URI, musí aplikace zajistit, aby používaly identifikátor URI obsahující hodnotu hlavičky hostitele, nikoli cílový server v identifikátoru URI. Klíč použitý při ukládání prostředků do mezipaměti používá hodnotu hlavičky hostitele místo identifikátoru URI požadavku. Soubory cookie se ukládají do CookieContainer a logicky seskupují podle názvu domény serveru. Pokud aplikace určuje hlavičku hostitele, použije se tato hodnota jako doména.

Pokud Host vlastnost není nastavena, hodnota hlavičky hostitele, která se má použít v požadavku HTTP, je založena na identifikátoru URI požadavku.