HttpWebRequest.Host Vlastnost

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.Requests.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll
Zdroj:
HttpWebRequest.cs
Zdroj:
HttpWebRequest.cs
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 Host v požadavku HTTP.

Výjimky

ArgumentNullException

Hlavičku Hostitele nelze nastavit na nullhodnotu .

ArgumentException

Hlavičku Host nelze nastavit na neplatnou hodnotu.

InvalidOperationException

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