HttpCookie(String, String, String) 建構函式

定義

命名空間:

Windows.Web.Http

使用指定的名稱、網域和路徑，初始化 HttpCookie 類別的新實例。

public:
 HttpCookie(Platform::String ^ name, Platform::String ^ domain, Platform::String ^ path);

 HttpCookie(winrt::hstring const& name, winrt::hstring const& domain, winrt::hstring const& path);

public HttpCookie(string name, string domain, string path);

function HttpCookie(name, domain, path)

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

參數

name

String

Platform::String

winrt::hstring

HttpCookie 的名稱

domain

String

Platform::String

winrt::hstring

HttpCookie 有效網域。

path

String

Platform::String

winrt::hstring

HttpCookie 套用的 URI。

備註

在 Visual Basic) 中，HttpCookie的名稱參數無法設定為 null (Nothing。

屬性應該是 RFC 2616 和 RFC 6265 中所定義的令牌。

下列字元會當做分隔符使用，無法在 name 參數中使用：

• 左剖析 (『 (』)
• right paren (') ')
• 大於 (『>)
• 小於 (『<)
• at sign ('@')
• 逗號 ('，')
• 分號 (';')
• 冒號 (『：』)
• 反斜杠 (『\』)
• 雙引號 (』“')
• 正斜線 (『/』)
• 左方括弧 (『[』)
• 右方括弧 (']')
• 問號 ('？')
• 等號 (『=』)
• 左波浪括弧 (『{』)
• 右波浪括弧 (『}』)
• 新行 (『\n』)
• return ('\r“)
• space (' ')
• tab ('\t“)

*domain * 參數會指定要傳送 HttpCookie 的主機。 具有 *domain * 參數的 .contoso.com Cookie 會傳送至 contoso.com 網域，而所有子域 (www.contoso.com 和 info.contoso.com，例如) 。

具有 *domain * 參數的 info.contoso.com Cookie 不會傳送至 或 www.contoso.com，但會傳送至 contoso.cominfo.contoso.com 和 (和 us.info.contoso.com的所有子域uk.info.contoso.com，例如) 。

如果未指定 網域 參數， 則 HttpCookie 只會傳送至接收此 Cookie 之主機的主機和子域。

path 參數會指定套用這個 HttpCookie 之源伺服器上的路徑子集。 如果未指定此參數，預設路徑會符合任何路徑， 而且 HttpCookie 將會在所有 HTTP 要求上傳送至 *domain * 參數指定的和所有子域。