CookieContainer クラス

定義

CookieCollection オブジェクトのコレクション用のコンテナーを提供します。Provides a container for a collection of CookieCollection objects.

public ref class CookieContainer
[System.Serializable]
public class CookieContainer
type CookieContainer = class
Public Class CookieContainer
継承
CookieContainer
属性

注釈

CookieContainer は、Cookie クラスのインスタンスのストレージを提供し、データベースに似た方法でアクセスするデータ構造です。A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. CookieContainer には、プロパティによってコンテナーが作成または変更されたときに設定される容量制限があります。The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Cookie クラスのインスタンスが、元の URI に基づいてコンテナーに追加されます。An instance of the Cookie class is added to the container based on its originating URI. これは、URI に関連付けられている内部 CookieCollection に追加されます。It is added to an internal CookieCollection associated with the URI. URI に基づいて CookieCollectionとして、または HTTP WebRequests を送信するために使用できる文字列として、Cookie がコンテナーから取得されます。A Cookie is retrieved from the container based on the URI as a CookieCollection, or as a string that can be used to submit HTTP WebRequests.

CookieContainer には、コンテナーのコンテンツのボリュームを管理する3つのプロパティ (CapacityMaxCookieSize、および PerDomainCapacity) があります。The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. これらの値の既定の設定は、それぞれ300、4096、および20です。These values have the default settings of 300, 4096, and 20 respectively. Cookie がコンテナーに追加されるときに、これらのプロパティを使用して、CookieContainer に既に含まれている Cookie を破棄して、新しいもの用の領域を確保する必要があるかどうかを判断します。When a Cookie is added to the container, these properties are used to determine whether a Cookie already contained in the CookieContainer should be discarded to make room for the new one. CookieContainer は、CapacityPerDomainCapacity の両方の制限を超えていないことを確認するために、各追加を追跡します。The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. 一方または両方を超えた場合、CookieContainer によって保持されている Cookie インスタンスは削除されます。If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. まず、期限切れの Cookie をすべて削除します。First, any expired Cookie is removed. さらに容量をキャプチャする必要がある場合は、最も最近使用した CookieCollection が削除されます。If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

コンストラクター

CookieContainer()

CookieContainer クラスの新しいインスタンスを初期化します。Initializes a new instance of the CookieContainer class.

CookieContainer(Int32)

コンテナーが保持できる CookieContainer インスタンスの数を指定して、Cookie クラスの新しいインスタンスを初期化します。Initializes a new instance of the CookieContainer class with a specified value for the number of Cookie instances that the container can hold.

CookieContainer(Int32, Int32, Int32)

CookieContainer クラスの新しいインスタンスを特定のプロパティを使用して初期化します。Initializes a new instance of the CookieContainer class with specific properties.

フィールド

DefaultCookieLengthLimit

Cookie が保持できる CookieContainer インスタンスの既定の最大サイズをバイト単位で表します。Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. このフィールドは定数です。This field is constant.

DefaultCookieLimit

Cookie が保持できる CookieContainer インスタンスの既定の最大数を表します。Represents the default maximum number of Cookie instances that the CookieContainer can hold. このフィールドは定数です。This field is constant.

DefaultPerDomainCookieLimit

Cookie がドメインごとに参照できる CookieContainer インスタンスの既定の最大数を表します。Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. このフィールドは定数です。This field is constant.

プロパティ

Capacity

Cookie で保持できる CookieContainer インスタンス数を取得または設定します。Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count

Cookie が現在保持している CookieContainer インスタンス数を取得します。Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize

Cookie の許容最大長を表します。Represents the maximum allowed length of a Cookie.

PerDomainCapacity

Cookie でドメインごとに格納できる CookieContainer インスタンスの数を取得または設定します。Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

メソッド

Add(Cookie)

CookieCookieContainer に追加します。Adds a Cookie to a CookieContainer. このメソッドは、Cookie のドメインを使用して、Cookie に関連付けるドメイン コレクションを決定します。This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection)

CookieCollectionCookieContainer の内容を追加します。Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie)

Cookie を特定の URI の CookieContainer に追加します。Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection)

CookieCollection の内容を特定の URI の CookieContainer に追加します。Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetCookieHeader(Uri)

特定の URI に関連付けられている Cookie インスタンスを表す HTTP クッキーを格納する HTTP クッキー ヘッダーを取得します。Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri)

特定の URI に関連付けられている CookieCollection インスタンスを格納する Cookie を取得します。Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
SetCookies(Uri, String)

HTTP クッキー ヘッダーの 1 つ以上のクッキーの Cookie インスタンスを特定の URI の CookieContainer に追加します。Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

適用対象

こちらもご覧ください