HttpWebRequest.Host Eigenschaft

Definition

Ruft den Hostheaderwert ab, der in einer HTTP-Anforderung unabhängig vom Anforderungs-URI verwendet werden soll, oder legt ihn fest.Gets or sets the Host header value to use in an HTTP request independent from the request URI.

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.The Host header value in the HTTP request.

Ausnahmen

Der Hostheader kann nicht auf null festgelegt werden.The Host header cannot be set to null.

Der Hostheader kann nicht auf einen ungültigen Wert festgelegt werden.The Host header cannot be set to an invalid value.

Der Hostheader kann nicht festgelegt werden, nachdem das Senden von HttpWebRequest bereits gestartet wurde.The Host header cannot be set after the HttpWebRequest has already started to be sent.

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.The Host property can be used to set the Host header value to use in an HTTP request independent from the request URI. Die Host-Eigenschaft kann aus einem Hostnamen und einer optionalen Portnummer bestehen.The Host property can consist of a hostname and an optional port number. Ein Host Header ohne Port Informationen impliziert den Standardport für den angeforderten Dienst (z. b. Port 80 für eine HTTP-URL).A Host header without port information implies the default port for the service requested (port 80 for an HTTP URL, for example).

Das Format zum Angeben eines Hosts und Ports muss den Regeln im Abschnitt 14,23 von rfc2616 entsprechen, die vom IETF veröffentlicht werden.The format for specifying a host and port must follow the rules in section 14.23 of RFC2616 published by the IETF. Ein Beispiel für die Erfüllung dieser Anforderungen, die den Port 8080 angibt, wäre der folgende Wert für die Host-Eigenschaft:An example complying with these requirements that specifies a port of 8080 would be the following value for the Host property:

www.contoso.com:8080

Wenn Sie die Host-Eigenschaft verwenden, um einen benutzerdefinierten Host Header Wert explizit anzugeben, wirkt sich dies auch auf Zwischenspeicherung, Cookies und Authentifizierung ausUsing the Host property to explicitly specify a custom Host header value also affects areas caching, cookies, and authentication. Wenn eine Anwendung Anmelde Informationen für ein bestimmtes URI-Präfix bereitstellt, müssen die Anwendungen sicherstellen, dass der URI, der den Wert des Host Headers enthält, nicht der Zielserver im URI verwendet wird.When an application provides credentials for a specific URI prefix, the applications needs to make sure to use the URI containing the value of the Host header, not the target server in the URI. Der Schlüssel, der beim Zwischenspeichern von Ressourcen verwendet wird, verwendet den Host Header Wert anstelle des Anforderungs-URI.The key used when caching resources, uses the Host header value rather than the request URI. Cookies werden in einem CookieContainer gespeichert und logisch nach dem Server Domänen Namen gruppiert.Cookies are stored in a CookieContainer and logically grouped by the server domain name. Wenn die Anwendung einen Host Header angibt, wird dieser Wert als Domäne verwendet.If the application specifies a Host header, then this value will be used as domain.

Wenn die Host-Eigenschaft nicht festgelegt ist, basiert der Host Header Wert, der in einer HTTP-Anforderung verwendet werden soll, auf dem Anforderungs-URI.If the Host property is not set, then the Host header value to use in an HTTP request is based on the request URI.

Gilt für: