HttpWebRequest.Host Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Quelle:

HttpWebRequest.cs

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, set

Public Property Host As String

Eigenschaftswert

String

Der Hostheaderwert in der HTTP-Anforderung.

Ausnahmen

ArgumentNullException

Der Hostheader kann nicht auf null festgelegt werden.

ArgumentException

Der Hostheader kann nicht auf einen ungültigen Wert festgelegt werden.

InvalidOperationException

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 der RFC2616 entsprechen, die von der IETF veröffentlicht werden. Ein Beispiel, das diese Anforderungen erfüllt und 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 Hostheaderwerts wirkt sich auch auf die Bereiche 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 enthält, und nicht den Zielserver im URI. Der Beim Zwischenspeichern von Ressourcen verwendete Schlüssel verwendet den Hostheaderwert anstelle des Anforderungs-URI. Cookies werden in einem CookieContainer gespeichert und logisch nach dem 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.