HttpWebRequest.Host Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
Hodnota hlavičky Host v požadavku HTTP.
Výjimky
Hlavičku Hostitele nelze nastavit na null
hodnotu .
Hlavičku Host nelze nastavit na neplatnou hodnotu.
Hlavičku Host nelze nastavit, jakmile HttpWebRequest již začala být odesílána.
Poznámky
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 pro požadovanou službu (například port 80 pro adresu URL PROTOKOLU HTTP).
Formát pro určení hostitele a portu musí odpovídat pravidlu v oddílu 14.23 RFC2616 publikovaných IETF. Příklad vyhovující 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 k explicitní zadání vlastní hodnoty hlavičky hostitele má také vliv na ukládání oblastí do mezipaměti, soubory cookie a ověřování. Když aplikace poskytuje přihlašovací údaje pro konkrétní předponu identifikátoru URI, musí se ujistit, že používají 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í nastavená, pak je hodnota hlavičky hostitele, která se má použít v požadavku HTTP, založena na identifikátoru URI požadavku.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro