Freigeben über


HttpWebRequest.Host Eigenschaft

Definition

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, set
Public Property Host As String

Eigenschaftswert

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.

Gilt für: