HttpWebRequest.Host 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置要在 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
属性值
HTTP 请求中的 Host 标头值。
例外
无法将 Host 标头设置为 null
。
无法将 Host 标头设置为无效值。
无法在已开始发送 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。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈