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, set
Public Property Host As String
Eigenschaftswert
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 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.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für