HttpWebRequest.Host 屬性

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.Requests.dll

來源:

HttpWebRequest.cs

取得或設定主機標頭值，以用於與要求 URI 無關的 HTTP 要求中。

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

屬性值

String

HTTP 要求中的 Host 標頭值。

例外狀況

ArgumentNullException

Host 標頭無法設定為 null。

ArgumentException

主機標頭無法設定為無效的值。

InvalidOperationException

Host標頭在已經開始傳送後 HttpWebRequest 再設定。

備註

謹慎

WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時，你不應該用它們來做新開發。 請改用 HttpClient。

Host此屬性可用來設定 Host 標頭值，使其在 HTTP 請求中使用，且獨立於請求 URI。 該 Host 屬性可由主機名稱及可選的埠號組成。 不含埠資訊的主機標頭表示所要求的服務的預設埠（例如 HTTP URL 的埠 80）。

指定主機和埠的格式必須遵循 IETF 所發行RFC2616第 14.23 節中的規則。 符合這些要求並指定 8080 埠的範例是該 Host 屬性的以下數值：

www.contoso.com:8080

使用該 Host 屬性明確指定自訂主機標頭值，也會影響區域快取、Cookie 及認證。 當應用程式提供特定 URI 前置詞的認證時，應用程式必須確定使用包含主機標頭值的 URI，而不是 URI 中的目標伺服器。 快取資源時所使用的金鑰會使用主機標頭值，而不是要求 URI。 Cookie 會儲存在 a CookieContainer ，並依伺服器網域名稱邏輯分組。 如果應用程式指定主機標頭，則此值會當做網域使用。

若未設定該 Host 屬性，則 HTTP 請求中使用的 Host 標頭值將基於請求 URI。