CookieContainer

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

CookieContainer クラス

CookieCollection オブジェクトのコレクション用のコンテナを提供します。

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

Visual Basic (宣言)

<SerializableAttribute> _
Public Class CookieContainer

Visual Basic (使用法)

Dim instance As CookieContainer

C#

[SerializableAttribute] 
public class CookieContainer

C++

[SerializableAttribute] 
public ref class CookieContainer

J#

/** @attribute SerializableAttribute() */ 
public class CookieContainer

JScript

SerializableAttribute 
public class CookieContainer

解説

CookieContainer は、Cookie クラスのインスタンスに対してストレージを提供するデータ構造体であり、データベースのような方法でアクセスされます。CookieContainer には容量制限があり、コンテナの作成時またはプロパティの変更によって設定されます。

Cookie クラスのインスタンスは、送信元の URI に基づいてコンテナに追加されます。このインスタンスは、URI に関連付けられている内部 CookieCollection に追加されます。Cookie は、URI に基づいて CookieCollection として取得されるか、HTTP WebRequests の送信用文字列としてコンテナから取得されます。

CookieContainer は、コンテナの内容のボリュームを制御する 3 つのプロパティ、Capacity、MaxCookieSize、および PerDomainCapacity を持っています。これらのプロパティは、それぞれ既定値 300、4096、および 20 に設定されています。Cookie をコンテナに追加すると、これらのプロパティを使用して、新しいコンテナの領域を確保するために CookieContainer に既に格納されている Cookie を破棄する必要があるかどうかを決定します。CookieContainer は、各コンテナの追加を追跡し、Capacity の制限および PerDomainCapacity の制限を超過しないようにします。一方または両方の制限を超過している場合は、CookieContainer で保持されている Cookie インスタンスが削除されます。最初に、有効期限が切れた Cookie はすべて削除されます。さらに容量を確保する必要がある場合は、使用されてから最も時間が経過している CookieCollection がパージされます。

継承階層

System.Object
  System.Net.CookieContainer

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
CookieContainer メンバ
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException
ICollection

CookieContainer コンストラクタ ()

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

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CookieContainer

C#

public CookieContainer ()

C++

public:
CookieContainer ()

J#

public CookieContainer ()

JScript

public function CookieContainer ()

解説

既定のコンストラクタは、すべてのフィールドを既定値に初期化します。DefaultCookieLimit は、Capacity を初期化するために使用され、DefaultCookieLengthLimit は、MaxCookieSize に使用され、DefaultPerDomainCookieLimit は PerDomainCapacity に使用されます。

プラットフォーム

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

参照

関連項目
CookieContainer クラス
CookieContainer メンバ
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException

CookieContainer コンストラクタ (Int32, Int32, Int32)

CookieContainer クラスの新しいインスタンスを特定のプロパティを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    capacity As Integer, _
    perDomainCapacity As Integer, _
    maxCookieSize As Integer _
)

Visual Basic (使用法)

Dim capacity As Integer
Dim perDomainCapacity As Integer
Dim maxCookieSize As Integer

Dim instance As New CookieContainer(capacity,
 perDomainCapacity, maxCookieSize)

C#

public CookieContainer (
    int capacity,
    int perDomainCapacity,
    int maxCookieSize
)

C++

public:
CookieContainer (
    int capacity, 
    int perDomainCapacity, 
    int maxCookieSize
)

J#

public CookieContainer (
    int capacity, 
    int perDomainCapacity, 
    int maxCookieSize
)

JScript

public function CookieContainer (
    capacity : int, 
    perDomainCapacity : int, 
    maxCookieSize : int
)

パラメータ

capacity

CookieContainer が保持できる Cookie インスタンス数。

perDomainCapacity

ドメインごとの Cookie インスタンス数。

maxCookieSize

CookieContainer 内のすべての単一の Cookie の最大サイズ (バイト単位)。

例外

例外の種類	条件
ArgumentException	perDomainCapacity と MaxValue が等しくありません。 および perDomainCapacity が 0 以下か、perDomainCapacity が capacity を超えています。
ArgumentException	maxCookieSize が 0 以下です。

解説

パラメータは、Capacity、MaxCookieSize、および PerDomainCapacity の値を指定します。

プラットフォーム

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

参照

関連項目
CookieContainer クラス
CookieContainer メンバ
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException

CookieContainer コンストラクタ (Int32)

コンテナが保持できる Cookie インスタンスの数を指定して、CookieContainer クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    capacity As Integer _
)

Visual Basic (使用法)

Dim capacity As Integer

Dim instance As New CookieContainer(capacity)

C#

public CookieContainer (
    int capacity
)

C++

public:
CookieContainer (
    int capacity
)

J#

public CookieContainer (
    int capacity
)

JScript

public function CookieContainer (
    capacity : int
)

パラメータ

capacity

CookieContainer が保持できる Cookie インスタンス数。

例外

例外の種類	条件
ArgumentException	capacity が 0 以下です。

解説

PerDomainCapacity は 20 に初期化され、MaxCookieSize は 4096 に初期化されます。

プラットフォーム

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

参照

関連項目
CookieContainer クラス
CookieContainer メンバ
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException

CookieContainer コンストラクタ

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

名前	説明
CookieContainer ()	CookieContainer クラスの新しいインスタンスを初期化します。
CookieContainer (Int32)	コンテナが保持できる Cookie インスタンスの数を指定して、CookieContainer クラスの新しいインスタンスを初期化します。
CookieContainer (Int32, Int32, Int32)	CookieContainer クラスの新しいインスタンスを特定のプロパティを使用して初期化します。

参照

関連項目

CookieContainer クラス
CookieContainer メンバ
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException

CookieContainer フィールド

パブリック フィールド

	名前	説明
	DefaultCookieLengthLimit	CookieContainer が保持できる Cookie インスタンスの既定の最大サイズをバイト単位で表します。このフィールドは定数です。
	DefaultCookieLimit	CookieContainer が保持できる Cookie インスタンスの既定の最大数を表します。このフィールドは定数です。
	DefaultPerDomainCookieLimit	CookieContainer がドメインごとに参照できる Cookie インスタンスの既定の最大数を表します。このフィールドは定数です。

参照

関連項目

CookieContainer クラス
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException
ICollection

CookieContainer プロパティ

パブリック プロパティ

	名前	説明
	Capacity	CookieContainer が保持できる Cookie インスタンス数を取得または設定します。
	Count	CookieContainer が現在保持している Cookie インスタンス数を取得します。
	MaxCookieSize	Cookie の許容最大長を表します。
	PerDomainCapacity	ドメインごとに CookieContainer が保持できる Cookie インスタンス数を取得または設定します。

参照

関連項目

CookieContainer クラス
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException
ICollection

CookieContainer メソッド

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 Cookie を CookieContainer に追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetCookieHeader	特定の URI に関連付けられている Cookie インスタンスを表す HTTP cookie を格納する HTTP cookie ヘッダーを取得します。
	GetCookies	特定の URI に関連付けられている Cookie インスタンスを格納する CookieCollection を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	SetCookies	HTTP cookie ヘッダーの 1 つ以上の cookie の Cookie インスタンスを特定の URI の CookieContainer に追加します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

CookieContainer クラス
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException
ICollection

CookieContainer メンバ

CookieCollection オブジェクトのコレクション用のコンテナを提供します。

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

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

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

パブリック フィールド

	名前	説明
	DefaultCookieLengthLimit	CookieContainer が保持できる Cookie インスタンスの既定の最大サイズをバイト単位で表します。このフィールドは定数です。
	DefaultCookieLimit	CookieContainer が保持できる Cookie インスタンスの既定の最大数を表します。このフィールドは定数です。
	DefaultPerDomainCookieLimit	CookieContainer がドメインごとに参照できる Cookie インスタンスの既定の最大数を表します。このフィールドは定数です。

パブリック プロパティ

	名前	説明
	Capacity	CookieContainer が保持できる Cookie インスタンス数を取得または設定します。
	Count	CookieContainer が現在保持している Cookie インスタンス数を取得します。
	MaxCookieSize	Cookie の許容最大長を表します。
	PerDomainCapacity	ドメインごとに CookieContainer が保持できる Cookie インスタンス数を取得または設定します。

パブリック メソッド

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

	名前	説明
	Add	オーバーロードされます。 Cookie を CookieContainer に追加します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetCookieHeader	特定の URI に関連付けられている Cookie インスタンスを表す HTTP cookie を格納する HTTP cookie ヘッダーを取得します。
	GetCookies	特定の URI に関連付けられている Cookie インスタンスを格納する CookieCollection を取得します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	SetCookies	HTTP cookie ヘッダーの 1 つ以上の cookie の Cookie インスタンスを特定の URI の CookieContainer に追加します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

CookieContainer クラス
System.Net 名前空間
Cookie クラス
CookieCollection クラス
CookieContainer クラス
CookieException
ICollection