WebHeaderCollection

.NET Framework クラス ライブラリ リファレンス

WebHeaderCollection クラス

要求または応答に関連付けられたプロトコル ヘッダーを格納します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class WebHeaderCollection
    Inherits NameValueCollection
    Implements ISerializable

Visual Basic (使用法)

Dim instance As WebHeaderCollection

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class WebHeaderCollection : NameValueCollection,
 ISerializable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class WebHeaderCollection : public
 NameValueCollection, ISerializable

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class WebHeaderCollection extends NameValueCollection
 implements ISerializable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class WebHeaderCollection extends
 NameValueCollection implements ISerializable

解説

WebHeaderCollection クラスには、通常 WebRequest.Headers または WebResponse.Headers を使用してアクセスします。一部の共通ヘッダーは制限付きと見なされ、API (Content-Type など) によって直接公開されるか、システムによって保護され、変更できません。

制限付きヘッダーを次に示します。

• Accept

• Connection

• Content-Length

• Content-Type

• 日付

• Expect

• Host

• If-Modified-Since

• Range

• Referer

• Transfer-Encoding

• User-Agent

• Proxy-Connection

継承階層

System.Object
   System.Collections.Specialized.NameObjectCollectionBase
     System.Collections.Specialized.NameValueCollection
      System.Net.WebHeaderCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebHeaderCollection メンバ
System.Net 名前空間

WebHeaderCollection コンストラクタ ()

WebHeaderCollection クラスの新しいインスタンスを初期化します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New WebHeaderCollection

C#

public WebHeaderCollection ()

C++

public:
WebHeaderCollection ()

J#

public WebHeaderCollection ()

JScript

public function WebHeaderCollection ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
WebHeaderCollection クラス
WebHeaderCollection メンバ
System.Net 名前空間

WebHeaderCollection コンストラクタ (SerializationInfo, StreamingContext)

SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、WebHeaderCollection クラスの新しいインスタンスを初期化します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    serializationInfo As SerializationInfo, _
    streamingContext As StreamingContext _
)

Visual Basic (使用法)

Dim serializationInfo As SerializationInfo
Dim streamingContext As StreamingContext

Dim instance As New WebHeaderCollection(serializationInfo,
 streamingContext)

C#

protected WebHeaderCollection (
    SerializationInfo serializationInfo,
    StreamingContext streamingContext
)

C++

protected:
WebHeaderCollection (
    SerializationInfo^ serializationInfo, 
    StreamingContext streamingContext
)

J#

protected WebHeaderCollection (
    SerializationInfo serializationInfo, 
    StreamingContext streamingContext
)

JScript

protected function WebHeaderCollection (
    serializationInfo : SerializationInfo, 
    streamingContext : StreamingContext
)

パラメータ

serializationInfo

WebHeaderCollection をシリアル化するために必要な情報を格納している SerializationInfo。

streamingContext

新しい WebHeaderCollection に関連付けられているシリアル化ストリームのソースを格納している StreamingContext。

例外

例外の種類	条件
ArgumentException	headerName に無効な文字が含まれています。
ArgumentNullException	headerName が null 参照または Empty です。

解説

このコンストラクタは、WebHeaderCollection クラスの ISerializable インターフェイスを実装します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebHeaderCollection クラス
WebHeaderCollection メンバ
System.Net 名前空間
その他の技術情報
XML シリアル化および SOAP シリアル化

WebHeaderCollection コンストラクタ

WebHeaderCollection クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
WebHeaderCollection ()	WebHeaderCollection クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
WebHeaderCollection (SerializationInfo, StreamingContext)	SerializationInfo クラスと StreamingContext クラスの指定したインスタンスから、WebHeaderCollection クラスの新しいインスタンスを初期化します。

参照

関連項目

WebHeaderCollection クラス
WebHeaderCollection メンバ
System.Net 名前空間

WebHeaderCollection プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AllKeys	オーバーライドされます。 コレクション内のすべてのヘッダー名 (キー) を取得します。
	Count	オーバーライドされます。 コレクション内のヘッダーの数を取得します。
	Item	オーバーロードされます。 指定したヘッダーを取得または設定します。
	Keys	オーバーライドされます。 コレクション内のヘッダー名 (キー) のコレクションを取得します。

プロテクト プロパティ

	名前	説明
	IsReadOnly	NameObjectCollectionBase インスタンスが読み取り専用かどうかを示す値を取得または設定します。 ( NameObjectCollectionBase から継承されます。)

参照

関連項目

WebHeaderCollection クラス
System.Net 名前空間

WebHeaderCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーロードされます。 新しいヘッダーをコレクションに挿入します。
	Clear	オーバーライドされます。 コレクションからすべてのヘッダーを削除します。
	CopyTo	NameValueCollection 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 ( NameValueCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Get	オーバーロードされます。 オーバーライドされます。 コレクションからヘッダーの値を取得します。
	GetEnumerator	オーバーライドされます。 WebHeaderCollection インスタンスを反復処理できる列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetKey	オーバーライドされます。 コレクション内の指定した位置のヘッダー名を取得します。
	GetObjectData	オーバーライドされます。 SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	GetValues	オーバーロードされます。 オーバーライドされます。 ヘッダーに格納されたヘッダー値の配列を取得します。
	HasKeys	NameValueCollection が、null 参照 (Visual Basic では Nothing) ではないキーを格納しているかどうかを示す値を取得します。 ( NameValueCollection から継承されます。)
	IsRestricted	オーバーロードされます。 指定した HTTP ヘッダーを設定できるかどうかをテストします。
	OnDeserialization	オーバーライドされます。 ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	オーバーロードされます。 指定したヘッダーをコレクションから削除します。
	Set	オーバーロードされます。 指定したヘッダーを指定した値に設定します。
	ToByteArray	WebHeaderCollection をバイト配列に変換します。
	ToString	オーバーライドされます。 互換性のために残されています。

プロテクト メソッド

	名前	説明
	AddWithoutValidate	ヘッダーが制限付きヘッダー一覧にあるかどうかを確認せずに、ヘッダーをコレクションに挿入します。
	BaseAdd	指定したキーと値を持つエントリを NameObjectCollectionBase インスタンスに追加します。 ( NameObjectCollectionBase から継承されます。)
	BaseClear	NameObjectCollectionBase インスタンスからすべてのエントリを削除します。 ( NameObjectCollectionBase から継承されます。)
	BaseGet	オーバーロードされます。 NameObjectCollectionBase インスタンスから、指定したエントリの値を取得します。 ( NameObjectCollectionBase から継承されます。)
	BaseGetAllKeys	NameObjectCollectionBase インスタンス内のすべてのキーを格納する String 配列を返します。 ( NameObjectCollectionBase から継承されます。)
	BaseGetAllValues	オーバーロードされます。 NameObjectCollectionBase インスタンス内のすべての値を格納する配列を返します。 ( NameObjectCollectionBase から継承されます。)
	BaseGetKey	NameObjectCollectionBase インスタンスの指定したインデックスにあるエントリのキーを取得します。 ( NameObjectCollectionBase から継承されます。)
	BaseHasKeys	NameObjectCollectionBase インスタンスが、キーが null 参照 (Visual Basic では Nothing) ではないエントリを格納しているかどうかを示す値を取得します。 ( NameObjectCollectionBase から継承されます。)
	BaseRemove	指定したキーを持つエントリを NameObjectCollectionBase インスタンスから削除します。 ( NameObjectCollectionBase から継承されます。)
	BaseRemoveAt	NameObjectCollectionBase インスタンスの指定したインデックスにあるエントリを削除します。 ( NameObjectCollectionBase から継承されます。)
	BaseSet	オーバーロードされます。 NameObjectCollectionBase インスタンス内のエントリの値を設定します。 ( NameObjectCollectionBase から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	InvalidateCachedArrays	コレクション内でキャッシュに保存された配列を null 参照 (Visual Basic では Nothing) にリセットします。 ( NameValueCollection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	このインスタンスを、指定した SerializationInfo オブジェクトにシリアル化します。

参照

関連項目

WebHeaderCollection クラス
System.Net 名前空間

WebHeaderCollection メンバ

要求または応答に関連付けられたプロトコル ヘッダーを格納します。

WebHeaderCollection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

( プロテクト コンストラクタ も参照)

	名前	説明
	WebHeaderCollection	オーバーロードされます。 WebHeaderCollection クラスの新しいインスタンスを初期化します。

プロテクト コンストラクタ

	名前	説明
	WebHeaderCollection	オーバーロードされます。 WebHeaderCollection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AllKeys	オーバーライドされます。 コレクション内のすべてのヘッダー名 (キー) を取得します。
	Count	オーバーライドされます。 コレクション内のヘッダーの数を取得します。
	Item	オーバーロードされます。 指定したヘッダーを取得または設定します。
	Keys	オーバーライドされます。 コレクション内のヘッダー名 (キー) のコレクションを取得します。

プロテクト プロパティ

	名前	説明
	IsReadOnly	NameObjectCollectionBase インスタンスが読み取り専用かどうかを示す値を取得または設定します。(NameObjectCollectionBase から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーロードされます。 新しいヘッダーをコレクションに挿入します。
	Clear	オーバーライドされます。 コレクションからすべてのヘッダーを削除します。
	CopyTo	NameValueCollection 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。 (NameValueCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Get	オーバーロードされます。 オーバーライドされます。 コレクションからヘッダーの値を取得します。
	GetEnumerator	オーバーライドされます。 WebHeaderCollection インスタンスを反復処理できる列挙子を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetKey	オーバーライドされます。 コレクション内の指定した位置のヘッダー名を取得します。
	GetObjectData	オーバーライドされます。 SerializationInfo に、オブジェクトをシリアル化するために必要なデータを設定します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	GetValues	オーバーロードされます。 オーバーライドされます。 ヘッダーに格納されたヘッダー値の配列を取得します。
	HasKeys	NameValueCollection が、null 参照 (Visual Basic では Nothing) ではないキーを格納しているかどうかを示す値を取得します。 (NameValueCollection から継承されます。)
	IsRestricted	オーバーロードされます。 指定した HTTP ヘッダーを設定できるかどうかをテストします。
	OnDeserialization	オーバーライドされます。 ISerializable インターフェイスを実装し、逆シリアル化が完了したときに逆シリアル化イベントを発生させます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	オーバーロードされます。 指定したヘッダーをコレクションから削除します。
	Set	オーバーロードされます。 指定したヘッダーを指定した値に設定します。
	ToByteArray	WebHeaderCollection をバイト配列に変換します。
	ToString	オーバーライドされます。 互換性のために残されています。

プロテクト メソッド

	名前	説明
	AddWithoutValidate	ヘッダーが制限付きヘッダー一覧にあるかどうかを確認せずに、ヘッダーをコレクションに挿入します。
	BaseAdd	指定したキーと値を持つエントリを NameObjectCollectionBase インスタンスに追加します。 (NameObjectCollectionBase から継承されます。)
	BaseClear	NameObjectCollectionBase インスタンスからすべてのエントリを削除します。 (NameObjectCollectionBase から継承されます。)
	BaseGet	オーバーロードされます。 NameObjectCollectionBase インスタンスから、指定したエントリの値を取得します。 (NameObjectCollectionBase から継承されます。)
	BaseGetAllKeys	NameObjectCollectionBase インスタンス内のすべてのキーを格納する String 配列を返します。 (NameObjectCollectionBase から継承されます。)
	BaseGetAllValues	オーバーロードされます。 NameObjectCollectionBase インスタンス内のすべての値を格納する配列を返します。 (NameObjectCollectionBase から継承されます。)
	BaseGetKey	NameObjectCollectionBase インスタンスの指定したインデックスにあるエントリのキーを取得します。 (NameObjectCollectionBase から継承されます。)
	BaseHasKeys	NameObjectCollectionBase インスタンスが、キーが null 参照 (Visual Basic では Nothing) ではないエントリを格納しているかどうかを示す値を取得します。 (NameObjectCollectionBase から継承されます。)
	BaseRemove	指定したキーを持つエントリを NameObjectCollectionBase インスタンスから削除します。 (NameObjectCollectionBase から継承されます。)
	BaseRemoveAt	NameObjectCollectionBase インスタンスの指定したインデックスにあるエントリを削除します。 (NameObjectCollectionBase から継承されます。)
	BaseSet	オーバーロードされます。 NameObjectCollectionBase インスタンス内のエントリの値を設定します。 (NameObjectCollectionBase から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	InvalidateCachedArrays	コレクション内でキャッシュに保存された配列を null 参照 (Visual Basic では Nothing) にリセットします。 (NameValueCollection から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

明示的インターフェイスの実装

	名前	説明
	System.Runtime.Serialization.ISerializable.GetObjectData	このインスタンスを、指定した SerializationInfo オブジェクトにシリアル化します。

参照

関連項目

WebHeaderCollection クラス
System.Net 名前空間