WebHeaderCollection 類別

定義

命名空間:

System.Net

組件:

System.Net.WebHeaderCollection.dll

來源:

WebHeaderCollection.cs

包含與要求或回應關聯的通訊協定 (Protocol) 標頭。

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+，其中沒有任何標頭受到限制。

受限制的標頭如下：

• 接受

• 連線

• Content-Length

• Content-Type

• Date

• Expect

• Host

• 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。