Cookie コンストラクター

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.Primitives.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.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.cs
ソース:
Cookie.cs
ソース:
Cookie.cs

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

public:
 Cookie();
public Cookie ();
Public Sub New ()

注釈

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

適用対象

ソース:
Cookie.cs
ソース:
Cookie.cs
ソース:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value);
public Cookie (string name, 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 間の区切り記号として使用されます。

こちらもご覧ください

適用対象

ソース:
Cookie.cs
ソース:
Cookie.cs
ソース:
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);
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 間の区切り記号として使用されます。

こちらもご覧ください

適用対象

ソース:
Cookie.cs
ソース:
Cookie.cs
ソース:
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);
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 間の区切り記号として使用されます。

こちらもご覧ください

適用対象