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 relativa all'host da usare 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, set
Public Property Host As String
Valore della proprietà
Il valore dell'intestazione relativa all'host nella richiesta HTTP.
Eccezioni
Impossibile impostare l'intestazione Host su null
.
Impossibile impostare l'intestazione Host su un valore non valido.
Impossibile impostare l'intestazione Host dopo che è già stato avviato l’invio di HttpWebRequest.
Commenti
La Host proprietà può essere usata per impostare il valore dell'intestazione Host da usare in una richiesta HTTP indipendente dall'URI della richiesta. La Host proprietà 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 (porta 80 per un URL HTTP, ad esempio).
Il formato per specificare un host e una porta deve seguire le regole nella sezione 14.23 di RFC2616 pubblicata da IETF. Un esempio conforme a questi requisiti che specifica una porta di 8080 sarebbe il valore seguente per la Host proprietà:
www.contoso.com:8080
L'uso della proprietà per specificare in modo esplicito un valore di intestazione host personalizzato influisce anche sulle aree di memorizzazione nella cache, nei cookie e nell'autenticazione Host . Quando un'applicazione fornisce le 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 durante la memorizzazione nella cache delle risorse usa il valore dell'intestazione Host anziché l'URI della richiesta. I cookie vengono archiviati in un CookieContainer oggetto e raggruppati logicamente dal nome di dominio del server. Se l'applicazione specifica un'intestazione Host, questo valore verrà usato come dominio.
Se la Host proprietà non è impostata, il valore dell'intestazione Host da usare in una richiesta HTTP è basato sull'URI della richiesta.
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per