HttpWebRequest.Host Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger värdet för värdhuvud som ska användas i en HTTP-begäran oberoende av begärande-URI:n.
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 StringEgenskapsvärde
Värdet värdhuvud i HTTP-begäran.
Undantag
Värdrubriken kan inte anges till null.
Värdrubriken kan inte anges till ett ogiltigt värde.
Det går inte att ange värdrubriken när den HttpWebRequest redan har börjat skickas.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Egenskapen Host kan användas för att ange värdet värdhuvud som ska användas i en HTTP-begäran oberoende av begärande-URI:n. Egenskapen Host kan bestå av ett värdnamn och ett valfritt portnummer. Ett värdhuvud utan portinformation innebär standardporten för den begärda tjänsten (till exempel port 80 för en HTTP-URL).
Formatet för att ange en värd och port måste följa reglerna i avsnitt 14.23 i RFC2616 som publicerats av IETF. Ett exempel som uppfyller dessa krav som anger en port på 8080 skulle vara följande värde för Host egenskapen:
www.contoso.com:8080
Host Att använda egenskapen för att uttryckligen ange ett anpassat värdhuvudvärde påverkar även cachelagring, cookies och autentisering. När ett program tillhandahåller autentiseringsuppgifter för ett specifikt URI-prefix måste programmen se till att använda URI:n som innehåller värdet för värdhuvudet, inte målservern i URI:n. Nyckeln som används vid cachelagring av resurser använder värdet värdhuvud i stället för begärande-URI:n. Cookies lagras i en CookieContainer och grupperas logiskt efter serverdomännamnet. Om programmet anger ett värdhuvud används det här värdet som domän.
Om egenskapen Host inte har angetts baseras värdet för värdhuvud som ska användas i en HTTP-begäran på begärande-URI:n.
