HttpWebRequest.Host Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Hostheaderwert ab, der in einer HTTP-Anforderung unabhängig vom Anforderungs-URI verwendet werden soll, oder legt ihn fest.
public:
property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };public string Host { get; set; }member this.Host : string with get, setPublic Property Host As StringEigenschaftswert
Der Hostheaderwert in der HTTP-Anforderung.
Ausnahmen
Der Hostheader kann nicht auf null festgelegt werden.
Der Hostheader kann nicht auf einen ungültigen Wert festgelegt werden.
Der Hostheader kann nicht festgelegt werden, nachdem das Senden von HttpWebRequest bereits gestartet wurde.
Hinweise
Die Host Eigenschaft kann verwendet werden, um den Host-Headerwert für die Verwendung in einer HTTP-Anforderung unabhängig vom Anforderungs-URI festgelegt. Die Host Eigenschaft kann aus einem Hostnamen und einer optionalen Portnummer bestehen. Ein Hostheader ohne Portinformationen impliziert den Standardport für den angeforderten Dienst (z. B. Port 80 für eine HTTP-URL).
Das Format zum Angeben eines Hosts und Ports muss den Regeln in Abschnitt 14.23 von RFC2616 entsprechen, die von der IETF veröffentlicht wurden. Ein Beispiel, das diese Anforderungen erfüllt, die einen Port von 8080 angibt, wäre der folgende Wert für die Host Eigenschaft:
www.contoso.com:8080
Die Verwendung der Host Eigenschaft zum expliziten Angeben eines benutzerdefinierten Hostheaders wirkt sich auch auf Zwischenspeicherung, Cookies und Authentifizierung aus. Wenn eine Anwendung Anmeldeinformationen für ein bestimmtes URI-Präfix bereitstellt, müssen die Anwendungen sicherstellen, dass der URI verwendet wird, der den Wert des Hostheaders enthält, nicht der Zielserver im URI. Der Schlüssel, der beim Zwischenspeichern von Ressourcen verwendet wird, verwendet anstelle des Anforderungs-URI den Hostheaderwert. Cookies werden in einem CookieContainer und logisch durch den Serverdomänennamen gruppiert. Wenn die Anwendung einen Hostheader angibt, wird dieser Wert als Domäne verwendet.
Wenn die Host Eigenschaft nicht festgelegt ist, basiert der Hostheaderwert, der in einer HTTP-Anforderung verwendet werden soll, auf dem Anforderungs-URI.