Cookie コンストラクター

定義

名前空間:

System.Net

アセンブリ:

System.Net.Primitives.dll

Cookie クラスの新しいインスタンスを初期化します。 通常、アプリケーションで Cookie クラスを構築する必要はありません。HTTP 応答で受信された Set-Cookie ヘッダーに基づいて自動的に作成されるからです。

オーバーロード

Cookie()	Cookie クラスの新しいインスタンスを初期化します。
Cookie(String, String)	指定した Cookie および Name を使用して、Value クラスの新しいインスタンスを初期化します。
Cookie(String, String, String)	指定した Cookie、Name、および Value を使用して、Path クラスの新しいインスタンスを初期化します。
Cookie(String, String, String, String)	指定した Cookie、Name、Value、および Path を使用して、Domain クラスの新しいインスタンスを初期化します。

Cookie()

ソース:

Cookie.cs

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

public:
 Cookie();

public Cookie ();

Public Sub New ()

注釈

パラメーターなしのコンストラクターは、および domainの空の文字列 ("") pathnamevalueを使用して、すべてのフィールドを既定値に初期化します。 クラスのインスタンスCookieを使用する前にName、少なくとも プロパティを初期化する必要があることに注意してください。

Cookie(String, String)

ソース:

Cookie.cs

指定した Cookie および Name を使用して、Value クラスの新しいインスタンスを初期化します。

public:
 Cookie(System::String ^ name, System::String ^ value);

public Cookie (string name, string? value);

new System.Net.Cookie : string * string -> System.Net.Cookie

Public Sub New (name As String, value As String)

パラメーター

name

String

Cookie の名前。 等号 (=)、セミコロン (;)、コンマ (,)、改行 (\n)、リターン (\r)、タブ (\t)、および空白文字は、name 内で使用しないでください。 ドル記号文字 ("$") を最初の文字にすることはできません。

value

String

Cookie の値。 セミコロン (;) とコンマ (,) は、value 内で使用しないでください。

例外

CookieException

name パラメーターが null です。

- または -

name パラメーターの長さが 0 です。

- または -

name パラメーターに無効な文字が含まれています。

- または -

value パラメーターが null です。

または

value パラメーターには、無効な文字を含む、引用符で囲まれていない文字列が含まれています。

注釈

パラメーターの既定値では、 value 空の文字列 ("") が使用されます。

のCookieパラメーターをvalue参照にnullすることはできません (Visual Basic では Nothing)。 セミコロン (";") 文字とコンマ (",") 文字は予約されており、パラメーターで渡される文字列を value 二重引用符で囲む場合を除き、 パラメーターで value 渡すことはできません。 そのため、次のコンストラクターの例は成功しますが、 メソッドまたは Add(Uri, Cookie) メソッドを使用Add(Cookie)してこれをCookieインスタンスにCookieContainer追加しようとすると、操作は失敗し、例外がスローされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

ただし、これらの特殊文字をエスケープした次のコンストラクターでは、 インスタンスにCookieContainer追加できる が作成Cookieされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

コンマ文字は、同じ行の個別の Cookie 間の区切り記号として使用されます。

こちらもご覧ください

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

ソース:

Cookie.cs

指定した Cookie、Name、および Value を使用して、Path クラスの新しいインスタンスを初期化します。

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);

public Cookie (string name, string? value, string? path);

new System.Net.Cookie : string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String)

パラメーター

name

String

Cookie の名前。 等号 (=)、セミコロン (;)、コンマ (,)、改行 (\n)、リターン (\r)、タブ (\t)、および空白文字は、name 内で使用しないでください。 ドル記号文字 ("$") を最初の文字にすることはできません。

value

String

Cookie の値。 セミコロン (;) とコンマ (,) は、value 内で使用しないでください。

path

String

この Cookie が適用される送信元サーバーの URI のサブセット。 既定値は "/" です。

例外

CookieException

name パラメーターが null です。

- または -

name パラメーターの長さが 0 です。

- または -

name パラメーターに無効な文字が含まれています。

- または -

value パラメーターが null です。

または

value パラメーターには、無効な文字を含む、引用符で囲まれていない文字列が含まれています。

注釈

パラメーターの既定値では、 path 空の文字列 ("") が使用されます。

のCookieパラメーターをvalue参照にnullすることはできません (Visual Basic では Nothing)。 セミコロン (";") 文字とコンマ (",") 文字は予約されており、パラメーターで渡される文字列を value 二重引用符で囲む場合を除き、 パラメーターで value 渡すことはできません。 そのため、次のコンストラクターの例は成功しますが、 メソッドまたは Add(Uri, Cookie) メソッドを使用Add(Cookie)してこれをCookieインスタンスにCookieContainer追加しようとすると、操作は失敗し、例外がスローされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

ただし、これらの特殊文字をエスケープした次のコンストラクターでは、 インスタンスにCookieContainer追加できる が作成Cookieされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

コンマ文字は、同じ行の個別の Cookie 間の区切り記号として使用されます。

こちらもご覧ください

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

ソース:

Cookie.cs

指定した Cookie、Name、Value、および Path を使用して、Domain クラスの新しいインスタンスを初期化します。

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);

public Cookie (string name, string? value, string? path, string? domain);

new System.Net.Cookie : string * string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String, domain As String)

パラメーター

name

String

Cookie の名前。 等号 (=)、セミコロン (;)、コンマ (,)、改行 (\n)、リターン (\r)、タブ (\t)、および空白文字は、name 内で使用しないでください。 ドル記号文字 ("$") を最初の文字にすることはできません。

value

String

Cookie オブジェクトの値。 セミコロン (;) とコンマ (,) は、value 内で使用しないでください。

path

String

この Cookie が適用される送信元サーバーの URI のサブセット。 既定値は "/" です。

domain

String

この Cookie が有効なオプションのインターネット ドメイン。 既定値は、この Cookie の送信元のホストです。

例外

CookieException

name パラメーターが null です。

- または -

name パラメーターの長さが 0 です。

- または -

name パラメーターに無効な文字が含まれています。

- または -

value パラメーターが null です。

または

value パラメーターには、無効な文字を含む、引用符で囲まれていない文字列が含まれています。

注釈

パラメーターと path パラメーターのdomain既定値では、空の文字列 ("") が使用されます。

のCookieパラメーターをvalue参照にnullすることはできません (Visual Basic では Nothing)。 セミコロン (";") 文字とコンマ (",") 文字は予約されており、パラメーターで渡される文字列を value 二重引用符で囲む場合を除き、 パラメーターで value 渡すことはできません。 そのため、次のコンストラクターの例は成功しますが、 メソッドまたは Add(Uri, Cookie) メソッドを使用Add(Cookie)してこれをCookieインスタンスにCookieContainer追加しようとすると、操作は失敗し、例外がスローされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

ただし、これらの特殊文字をエスケープした次のコンストラクターでは、 インスタンスにCookieContainer追加できる が作成Cookieされます。

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

コンマ文字は、同じ行の個別の Cookie 間の区切り記号として使用されます。

こちらもご覧ください

• CookieCollection
• CookieContainer
• CookieException