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()

初始化 Cookie 類別的新執行個體。

public:
 Cookie();

public Cookie ();

Public Sub New ()

備註

無參數建構函式會使用 、、 path 和 domain 的空字串 (「」「) name value ，將所有欄位初始化為其預設值。 請注意，至少必須先初始化 屬性， Name 才能使用 類別的 Cookie 實例。

Cookie(String, String)

使用指定的 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 的名稱。 name 內不可使用下列的字元：等號、分號、逗號、新行字元 (\n)、換行字元 (\r)、定位鍵 (\t) 及空格。 第一個字元不能是貨幣符號 ($) 字元。

value

String

Cookie 的值。 value 內不可使用下列的字元：分號 (;)、逗號 (,)。

例外狀況

CookieException

name 參數為 null。

-或- name 參數的長度為零。

-或- name 參數包含無效的字元。

-或- value 參數是 null。

-或- value 參數含有不是以引號括住、包含無效字元的字串。

備註

參數的 value 預設值會使用空字串 (「」) 。

的參數 value Cookie 不得為 null Visual Basic) 中 Nothing 的參考 (。 分號 (「;」) 和逗號 (「，」) 字元是保留的，除非參數中 value 傳入的字串以雙引號括住，否則無法傳入 value 參數。 因此，下列範例建構函式會成功，但當您嘗試使用 Add(Cookie) 或 Add(Uri, Cookie) 方法將此 Cookie 新增至 CookieContainer 實例時，作業將會失敗並擲回例外狀況：

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

不過，下列逸出特殊字元的建構函式會建立 Cookie 可新增至 實例的 CookieContainer ：

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、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 的名稱。 name 內不可使用下列的字元：等號、分號、逗號、新行字元 (\n)、換行字元 (\r)、定位鍵 (\t) 及空格。 第一個字元不能是貨幣符號 ($) 字元。

value

String

Cookie 的值。 value 內不可使用下列的字元：分號 (;)、逗號 (,)。

path

String

原始伺服器上這個 Cookie 要套用的 URI 子集。 預設值為 "/"。

例外狀況

CookieException

name 參數為 null。

-或- name 參數的長度為零。

-或- name 參數包含無效的字元。

-或- value 參數是 null。

-或- value 參數含有不是以引號括住、包含無效字元的字串。

備註

參數的 path 預設值會使用空字串 (「」) 。

的參數 value Cookie 不得為 null Visual Basic) 中 Nothing 的參考 (。 分號 (「;」) 和逗號 (「，」) 字元是保留的，除非參數中 value 傳入的字串以雙引號括住，否則無法傳入 value 參數。 因此，下列範例建構函式會成功，但當您嘗試使用 Add(Cookie) 或 Add(Uri, Cookie) 方法將此 Cookie 新增至 CookieContainer 實例時，作業將會失敗並擲回例外狀況：

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

不過，下列逸出特殊字元的建構函式會建立 Cookie 可新增至 實例的 CookieContainer ：

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、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 的名稱。 name 內不可使用下列的字元：等號、分號、逗號、新行字元 (\n)、換行字元 (\r)、定位鍵 (\t) 及空格。 第一個字元不能是貨幣符號 ($) 字元。

value

String

Cookie 物件的值。 value 內不可使用下列的字元：分號 (;)、逗號 (,)。

path

String

原始伺服器上這個 Cookie 要套用的 URI 子集。 預設值為 "/"。

domain

String

這個 Cookie 有效的選擇性網際網路網域。 預設值是發出這個 Cookie 的主機。

例外狀況

CookieException

name 參數為 null。

-或- name 參數的長度為零。

-或- name 參數包含無效的字元。

-或- value 參數是 null。

-或- value 參數含有不是以引號括住、包含無效字元的字串。

備註

和 path 參數的 domain 預設值會使用空字串 (「」) 。

的參數 value Cookie 不得為 null Visual Basic) 中 Nothing 的參考 (。 分號 (「;」) 和逗號 (「，」) 字元是保留的，除非參數中 value 傳入的字串以雙引號括住，否則無法傳入 value 參數。 因此，下列範例建構函式會成功，但當您嘗試使用 Add(Cookie) 或 Add(Uri, Cookie) 方法將此 Cookie 新增至 CookieContainer 實例時，作業將會失敗並擲回例外狀況：

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

不過，下列逸出特殊字元的建構函式會建立 Cookie 可新增至 實例的 CookieContainer ：

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

逗號字元會當做相同行上不同 Cookie 之間的分隔符號使用。

另請參閱

• CookieCollection
• CookieContainer
• CookieException