HttpWebRequest.Host Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore dell'intestazione Host da utilizzare in una richiesta HTTP indipendente dall'URI della richiesta.
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 StringValore della proprietà
Valore dell'intestazione Host nella richiesta HTTP.
Eccezioni
L'intestazione Host non può essere impostata su null.
L'intestazione Host non può essere impostata su un valore non valido.
Non è possibile impostare l'intestazione host dopo l'invio del HttpWebRequest.
Commenti
Cautela
WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.
La proprietà Host può essere usata per impostare il valore dell'intestazione Host da usare in una richiesta HTTP indipendente dall'URI della richiesta. La proprietà Host può essere costituita da un nome host e da un numero di porta facoltativo. Un'intestazione host senza informazioni sulla porta implica la porta predefinita per il servizio richiesto ,ad esempio la porta 80 per un URL HTTP.
Il formato per specificare un host e una porta deve seguire le regole nella sezione 14.23 di RFC2616 pubblicata da IETF. Un esempio di conformità a questi requisiti che specifica una porta 8080 sarà il valore seguente per la proprietà Host:
www.contoso.com:8080
L'uso della proprietà Host per specificare in modo esplicito un valore di intestazione host personalizzato influisce anche sulle aree di memorizzazione nella cache, i cookie e l'autenticazione. Quando un'applicazione fornisce credenziali per un prefisso URI specifico, le applicazioni devono assicurarsi di usare l'URI contenente il valore dell'intestazione Host, non il server di destinazione nell'URI. La chiave usata per la memorizzazione nella cache delle risorse usa il valore dell'intestazione Host anziché l'URI della richiesta. I cookie vengono archiviati in un CookieContainer e raggruppati logicamente in base al nome di dominio del server. Se l'applicazione specifica un'intestazione Host, questo valore verrà usato come dominio.
Se la proprietà Host non è impostata, il valore dell'intestazione Host da usare in una richiesta HTTP si basa sull'URI della richiesta.
