HttpWebRequest.Host Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Haalt de waarde van de hostheader op of stelt deze in voor gebruik in een HTTP-aanvraag, onafhankelijk van de aanvraag-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, setPublic Property Host As StringWaarde van eigenschap
De waarde van de hostheader in de HTTP-aanvraag.
Uitzonderingen
De hostheader kan niet worden ingesteld op null.
De hostheader kan niet worden ingesteld op een ongeldige waarde.
De hostheader kan niet worden ingesteld nadat de HttpWebRequest host al is verzonden.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
De Host eigenschap kan worden gebruikt om de hostheaderwaarde in te stellen voor gebruik in een HTTP-aanvraag, onafhankelijk van de aanvraag-URI. De Host eigenschap kan bestaan uit een hostnaam en een optioneel poortnummer. Een hostheader zonder poortgegevens impliceert bijvoorbeeld de standaardpoort voor de aangevraagde service (poort 80 voor een HTTP-URL).
De indeling voor het opgeven van een host en poort moet voldoen aan de regels in sectie 14.23 van RFC2616 gepubliceerd door de IETF. Een voorbeeld dat voldoet aan deze vereisten waarmee een poort van 8080 wordt opgegeven, is de volgende waarde voor de Host eigenschap:
www.contoso.com:8080
Het gebruik van de eigenschap om expliciet een aangepaste hostheaderwaarde op te geven, heeft ook invloed op gebieden die in de Host cache worden opgeslagen, cookies en verificatie. Wanneer een toepassing referenties voor een specifiek URI-voorvoegsel opgeeft, moeten de toepassingen ervoor zorgen dat de URI die de waarde van de hostheader bevat, niet de doelserver in de URI gebruikt. De sleutel die wordt gebruikt bij het opslaan van resources in de cache, gebruikt de waarde van de hostheader in plaats van de aanvraag-URI. Cookies worden opgeslagen in een CookieContainer en logisch gegroepeerd op de serverdomeinnaam. Als de toepassing een hostheader opgeeft, wordt deze waarde gebruikt als domein.
Als de Host eigenschap niet is ingesteld, is de waarde van de hostheader die moet worden gebruikt in een HTTP-aanvraag gebaseerd op de aanvraag-URI.