CookieContainer が保持できる Cookie インスタンス数を取得または設定します。
Public Property Capacity As Integer
[C#]
public int Capacity {get; set;}
[C++]
public: __property int get_Capacity();public: __property void set_Capacity(int);
[JScript]
public function get Capacity() : int;public function set Capacity(int);
プロパティ値
CookieContainer が保持できる Cookie インスタンス数。これは、ハード リミットであり、 Cookie を追加して超過させることはできません。
例外
例外の種類 | 条件 |
---|---|
ArgumentOutOfRangeException | Capacity が 0 以下または値が PerDomainCapacity 未満で、 PerDomainCapacity が MaxValue に等しくない場合です。 |
解説
Count が Capacity に等しいかまたはそれを超える場合は、1 つ以上の Cookie インスタンスがコンテナから削除されます。 Count を Capacity 未満にするために、十分な数のインスタンスが次のように削除されます。スコープ内に有効期限の切れた Cookie インスタンスがある場合は、クリーンアップされます。それ以外の場合は、最も以前に使用された CookieCollection が検出され、コンテナから削除されます。
Capacity は PerDomainCapacity 以上である必要があります。 PerDomainCapacity を設定し、現在の Cookie インスタンスの Count が新しい値未満の場合は、超過分がコンテナから削除されます。 Count を Capacity 未満にするために、十分な数のインスタンスが次のように削除されます。スコープ内に有効期限の切れた Cookie インスタンスがある場合は、クリーンアップされます。有効期限が切れたインスタンスがないか、または PerDomainCapacity の新しい値を超えるインスタンスがある場合は、最も以前に使用された CookieCollection が検索され、コンテナから削除されます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
CookieContainer クラス | CookieContainer メンバ | System.Net 名前空間 | Cookie | CookieCollection | CookieContainer | CookieException