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 diesen 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 nullfestgelegt werden.
Der Hostheader kann nicht auf einen ungültigen Wert festgelegt werden.
Der Hostheader kann nicht festgelegt werden, nachdem die HttpWebRequest bereits gesendet wurde.
Hinweise
Vorsicht
WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Die eigenschaft Host kann verwendet werden, um den Hostheaderwert festzulegen, der in einer HTTP-Anforderung unabhängig vom Anforderungs-URI verwendet werden soll. Die eigenschaft Host 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 für die Angabe eines Hosts und Ports muss den Regeln in Abschnitt 14.23 von RFC2616 folgen, die vom 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 eigenschaft Host:
www.contoso.com:8080
Die Verwendung der Host-Eigenschaft zur expliziten Angabe 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 sie den URI verwenden, der den Wert des Hostheaders und nicht den Zielserver im URI enthält. Der Schlüssel, der beim Zwischenspeichern von Ressourcen verwendet wird, verwendet den Hostheaderwert anstelle des Anforderungs-URI. Cookies werden in einer CookieContainer gespeichert und logisch nach dem Serverdomänennamen gruppiert. Wenn die Anwendung einen Hostheader angibt, wird dieser Wert als Domäne verwendet.
Wenn die eigenschaft Host nicht festgelegt ist, basiert der Hostheaderwert, der in einer HTTP-Anforderung verwendet werden soll, auf dem Anforderungs-URI.
