WebHeaderCollection 类

定义

命名空间:

System.Net

程序集:

System.Net.WebHeaderCollection.dll

Source:

WebHeaderCollection.cs

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

public ref class WebHeaderCollection : System::Collections::Specialized::NameValueCollection, System::Runtime::Serialization::ISerializable

public class WebHeaderCollection : System.Collections.Specialized.NameValueCollection, System.Runtime.Serialization.ISerializable

type WebHeaderCollection = class
    inherit NameValueCollection
    interface IEnumerable
    interface ISerializable

Public Class WebHeaderCollection
Inherits NameValueCollection
Implements ISerializable

继承

Object

NameObjectCollectionBase

NameValueCollection

WebHeaderCollection

实现

IEnumerable ISerializable

注解

类 WebHeaderCollection 通常通过 WebRequest.Headers 或 WebResponse.Headers进行访问。

在 .NET Framework 上，一些常见标头被视为受限制，要么由 API (直接公开，例如 Content-Type) ，要么受系统保护，不能更改。 这 不适用于 . NET Core 和 .NET 5+，其中没有任何标头受到限制。

受限制的标头包括：

• Accept

• 连接

• Content-Length

• Content-Type

• Date

• Expect

• 主机

• If-Modified-Since

• 范围

• Referer

• Transfer-Encoding

• User-Agent

• Proxy-Connection

构造函数

WebHeaderCollection()	初始化 WebHeaderCollection 类的新实例。
WebHeaderCollection(SerializationInfo, StreamingContext)	已过时. 从 WebHeaderCollection 和 SerializationInfo 类的指定实例初始化 StreamingContext 类的新实例。

属性

AllKeys	获取集合中的所有标头名（关键字）。
Count	获取集合中的标头数。
IsReadOnly	获取或设置一个值，通过该值指示 NameObjectCollectionBase 实例是否为只读的。 (继承自 NameObjectCollectionBase)
Item[HttpRequestHeader]	获取或设置指定的请求标头。
Item[HttpResponseHeader]	获取或设置指定的响应标头。
Item[Int32]	获取 NameValueCollection 中指定索引处的项。 (继承自 NameValueCollection)
Item[String]	获取或设置 NameValueCollection 中具有指定键的项。 (继承自 NameValueCollection)
Keys	获取集合中的标头名（关键字）的集合。

方法

Add(HttpRequestHeader, String)	将包含指定值的指定标头插入到集合中。
Add(HttpResponseHeader, String)	将包含指定值的指定标头插入到集合中。
Add(NameValueCollection)	将指定 NameValueCollection 中的项复制到当前 NameValueCollection。 (继承自 NameValueCollection)
Add(String)	将指定的标头插入集合中。
Add(String, String)	将具有指定名称和值的标头插入到集合中。
AddWithoutValidate(String, String)	将标头插入到集合中，不检查此标头是否在受限制的标头列表上。
BaseAdd(String, Object)	将具有指定键和值的项添加到 NameObjectCollectionBase 实例中。 (继承自 NameObjectCollectionBase)
BaseClear()	移除 NameObjectCollectionBase 实例中的所有项。 (继承自 NameObjectCollectionBase)
BaseGet(Int32)	获取 NameObjectCollectionBase 实例的指定索引处的项值。 (继承自 NameObjectCollectionBase)
BaseGet(String)	获取 NameObjectCollectionBase 实例中第一个具有指定键的项值。 (继承自 NameObjectCollectionBase)
BaseGetAllKeys()	返回 String 数组，该数组包含 NameObjectCollectionBase 实例中的所有键。 (继承自 NameObjectCollectionBase)
BaseGetAllValues()	返回 Object 数组，该数组包含 NameObjectCollectionBase 实例中的所有值。 (继承自 NameObjectCollectionBase)
BaseGetAllValues(Type)	返回指定类型的数组，该数组包含 NameObjectCollectionBase 实例中的所有值。 (继承自 NameObjectCollectionBase)
BaseGetKey(Int32)	获取 NameObjectCollectionBase 实例的指定索引处的项键。 (继承自 NameObjectCollectionBase)
BaseHasKeys()	获取一个值，通过该值指示 NameObjectCollectionBase 实例是否包含键不为 null 的项。 (继承自 NameObjectCollectionBase)
BaseRemove(String)	移除 NameObjectCollectionBase 实例中具有指定键的项。 (继承自 NameObjectCollectionBase)
BaseRemoveAt(Int32)	移除 NameObjectCollectionBase 实例的指定索引处的项。 (继承自 NameObjectCollectionBase)
BaseSet(Int32, Object)	设置 NameObjectCollectionBase 实例的指定索引处的项值。 (继承自 NameObjectCollectionBase)
BaseSet(String, Object)	为 NameObjectCollectionBase 实例中第一个具有指定键的项设置值（如果有这样的项）；否则将具有指定键和值的项添加到 NameObjectCollectionBase 实例中。 (继承自 NameObjectCollectionBase)
Clear()	从集合中移除所有标头。
CopyTo(Array, Int32)	从目标数组的指定索引处开始将整个 NameValueCollection 复制到兼容的一维 Array。 (继承自 NameValueCollection)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Get(Int32)	获取集合中特定标头的值，该值由索引指定到集合中。
Get(String)	获取集合中特定标头的值，该值由标头名指定。
GetEnumerator()	返回可循环访问 WebHeaderCollection 实例的枚举器。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetKey(Int32)	获取集合中位于指定位置的标头名。
GetObjectData(SerializationInfo, StreamingContext)	已过时. 使用将目标对象序列化所需的数据填充 SerializationInfo。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValues(Int32)	获取存储在标头集合的 index 位置中的标头值数组。
GetValues(String)	获取标头中存储的标头值数组。
HasKeys()	获取一个值，该值指示 NameValueCollection 是否包含非 null 的键。 (继承自 NameValueCollection)
InvalidateCachedArrays()	将集合的缓存数组重置为 null。 (继承自 NameValueCollection)
IsRestricted(String)	测试是否能够为请求设置指定的 HTTP 标头。
IsRestricted(String, Boolean)	测试是否能够为请求或响应设置指定的 HTTP 标头。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDeserialization(Object)	实现 ISerializable 接口，并在完成反序列化之后引发反序列化事件。
Remove(HttpRequestHeader)	从集合中移除指定的标头。
Remove(HttpResponseHeader)	从集合中移除指定的标头。
Remove(String)	从集合中移除指定的标头。
Set(HttpRequestHeader, String)	将指定的标头设置为指定的值。
Set(HttpResponseHeader, String)	将指定的标头设置为指定的值。
Set(String, String)	将指定的标头设置为指定的值。
ToByteArray()	将 WebHeaderCollection 转换为字节数组。
ToString()	此方法已过时。

显式接口实现

ICollection.CopyTo(Array, Int32)	从目标数组的指定索引处开始将整个 NameObjectCollectionBase 复制到兼容的一维 Array。 (继承自 NameObjectCollectionBase)
ICollection.IsSynchronized	获取一个值，该值指示对 NameObjectCollectionBase 对象的访问是否同步（线程安全）。 (继承自 NameObjectCollectionBase)
ICollection.SyncRoot	获取一个对象，该对象可用于同步对 NameObjectCollectionBase 对象的访问。 (继承自 NameObjectCollectionBase)
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	将此实例序列化到指定的 SerializationInfo 对象中。

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。