HttpWebRequest.Host 属性

定义

命名空间:

System.Net

程序集:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

获取或设置要在 HTTP 请求中独立于请求 URI 使用的 Host 标头值。

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

无法将 Host 标头设置为无效值。

InvalidOperationException

无法在已开始发送 HttpWebRequest 之后设置 Host 标头。

注解

属性 Host 可用于设置要在独立于请求 URI 的 HTTP 请求中使用的 Host 标头值。 属性 Host 可以包含主机名和可选端口号。 不带端口信息的主机标头意味着服务的默认端口 (端口 80 为 HTTP URL 请求，例如) 。

用于指定主机和端口的格式必须遵循 IETF 发布的RFC2616的第 14.23 节中的规则。 符合这些要求（指定端口 8080）的示例是 属性的以下值 Host ：

www.contoso.com:8080

Host使用 属性显式指定自定义 Host 标头值也会影响区域缓存、Cookie 和身份验证。 当应用程序提供特定 URI 前缀的凭据时，应用程序需要确保使用包含 Host 标头值的 URI，而不是 URI 中的目标服务器。 缓存资源时使用的密钥使用 Host 标头值而不是请求 URI。 Cookie 存储在 中， CookieContainer 并按服务器域名进行逻辑分组。 如果应用程序指定了 Host 标头，则此值将用作域。

Host如果未设置 属性，则在 HTTP 请求中使用的 Host 标头值基于请求 URI。