HttpWebRequest.Host 屬性

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

HttpWebRequest.cs

取得或設定 Host 標頭值，以用在獨立於要求 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

主機標頭無法設定為 null。

ArgumentException

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

InvalidOperationException

HttpWebRequest 已經開始傳送之後，則無法設定主機標頭。

備註

Host屬性可用來設定主機標頭值，以在與要求 URI 無關的 HTTP 要求中使用。 屬性 Host 可以包含主機名和選擇性埠號碼。 沒有埠資訊的主機標頭表示 HTTP URL (埠 80 要求之服務的預設埠，例如) 。

指定主機和埠的格式必須遵循 IETF 所發行RFC2616 14.23 節中的規則。 符合這些需求的範例，指定埠 8080 會是 屬性的下列值 Host ：

www.contoso.com:8080

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

Host如果未設定 屬性，則 HTTP 要求中使用的主機標頭值會以要求 URI 為基礎。