HttpWebRequest.Host Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, 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 nullhodnotu .

ArgumentException

Hlavičku Hostitele nelze nastavit na neplatnou hodnotu.

InvalidOperationException

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

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 vlastnosti Host :

www.contoso.com:8080

Host Použití vlastnosti explicitně zadat vlastní hodnotu 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.

Host Pokud 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.