此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

WebHeaderCollection 类

2013/12/13

包含与请求或响应关联的协议标头。

System.Object
  System.Net.WebHeaderCollection

Namespace:  System.Net
程序集:  System.Net(位于 System.Net.dll 中)

public sealed class WebHeaderCollection : IEnumerable

WebHeaderCollection 类型公开以下成员。

  名称说明
公共方法WebHeaderCollection初始化 WebHeaderCollection 类的新实例。
返回顶部

  名称说明
公共属性AllKeys获取与请求关联的标头名称/值对集合。
公共属性Count获取集合中标头的数量。
公共属性Item[HttpRequestHeader]获取或设置指定的请求标头。
公共属性Item[String]获取或设置指定的请求标头。
返回顶部

  名称说明
公共方法Equals(Object)确定指定的 Object 是否等于当前的 Object (从 Object 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetHashCode用作特定类型的哈希函数。 (从 Object 继承。)
公共方法GetType获取当前实例的 Type (从 Object 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString返回表示当前 WebHeaderCollectionString (重写 Object.ToString()。)
返回顶部

  名称说明
公共扩展方法AsQueryableIEnumerable 转换为 IQueryable (由 Queryable 定义。)
公共扩展方法Cast<TResult>IEnumerable 的元素转换为指定的类型。 (由 Enumerable 定义。)
公共扩展方法OfType<TResult>根据指定类型筛选 IEnumerable 的元素。 (由 Enumerable 定义。)
返回顶部

  名称说明
显式接口实现私有方法IEnumerable.GetEnumerator返回可循环访问 WebHeaderCollection 实例的枚举数。
返回顶部

通常通过 WebRequest.Headers 属性来访问 WebHeaderCollection 类。

Item 属性可用于获取存储在 WebHeaderCollection 对象中的标头的值。Item[HttpRequestHeader] 属性可用于获取在 HttpRequestHeader 枚举中定义的公共标头的值。Item[String] 属性可用于获取自定义标头和未在 HttpRequestHeader 枚举中定义的标头的值。

Item 属性可用于在 WebHeaderCollection 对象中设置自定义标头以供 WebClientHttpWebRequest 对象使用。

某些公共标头被视为受限制,它们或者直接公开(如 Content-Type),或者受到系统保护,不能在 WebHeaderCollection 对象中设置或更改。尝试在与 HttpWebRequest 对象关联的 WebHeaderCollection 对象中设置这些受限制的标头之一将引发异常。如果尝试在与 WebClient 对象关联的 WebHeaderCollection 对象中设置这些受限制的标头之一,则会在以后尝试发送 WebClient 请求时引发异常。

出于安全原因,除非特定标头得到适用于目标跨域站点的安全策略的允许,否则,将限制将特定标头发送到跨域站点。此限制适用于来自原始网站之外的地点的资源。使用 Headers 属性可设置 Authorization 标头。但是,若要正确地设置凭据,适用于该目标的跨域策略必须具有 HTTP 请求标头设置,以允许发送授权标头。

不应该假设标头值会保持不变,因为 Web 服务器和缓存可能会更改标头或向 Web 请求添加标头。

功能

如果您在应用中使用此 API,您必须在应用清单中指定下列功能。否则,您的应用可能无法正常工作,或可能意外退出。

ID_CAP_NETWORKING

Windows Phone 8, Windows Phone OS 7.1

有关更多信息,请参见 Windows Phone 应用的功能和硬件要求

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

此类型的所有公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

显示:
© 2015 Microsoft