共用方式為


Cookie 建構函式

定義

初始化 Cookie 類別的新執行個體。 一般而言,應用程式並不需要建構 Cookie 類別,因為它會自動依據由 HTTP 回應接收的 Set-Cookie 標頭建立。

多載

Cookie()

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

Cookie(String, String)

使用指定的 CookieName 初始化 Value 類別的新執行個體。

Cookie(String, String, String)

使用指定的 CookieNameValue,初始化 Path 類別的新執行個體。

Cookie(String, String, String, String)

使用指定的 CookieNameValuePath,初始化 Domain 類別的新執行個體。

來源:
Cookie.cs
來源:
Cookie.cs
來源:
Cookie.cs

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

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

備註

無參數建構函式會使用 、、 pathdomain的空字串 (“”“) namevalue,將所有字段初始化為其預設值。 請注意,至少必須先初始化 屬性, Name 才能使用 類別的 Cookie 實例。

適用於

來源:
Cookie.cs
來源:
Cookie.cs
來源:
Cookie.cs

使用指定的 CookieName 初始化 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 內不可使用下列的字元:分號 (;)、逗號 (,)。

例外狀況

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 之間的分隔符使用。

另請參閱

適用於

來源:
Cookie.cs
來源:
Cookie.cs
來源:
Cookie.cs

使用指定的 CookieNameValue,初始化 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 子集。 預設值為 "/"。

例外狀況

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 之間的分隔符使用。

另請參閱

適用於

來源:
Cookie.cs
來源:
Cookie.cs
來源:
Cookie.cs

使用指定的 CookieNameValuePath,初始化 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 的主機。

例外狀況

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 之間的分隔符使用。

另請參閱

適用於