指定 Cookie 在 Web 應用程式中的使用方式。
Syntax
class AnonymousIdentificationSection : ConfigurationSection
方法
下表列出 類別所 AnonymousIdentificationSection 公開的方法。
| 名稱 | 描述 |
|---|---|
| GetAllowDefinition | (繼承自 ConfigurationSection.) |
| GetAllowLocation | (繼承自 ConfigurationSection。) |
| RevertToParent | (繼承自 ConfigurationSection。) |
| SetAllowDefinition | (繼承自 ConfigurationSection。) |
| SetAllowLocation | (繼承自 ConfigurationSection。) |
屬性
下表列出 類別所 AnonymousIdentificationSection 公開的屬性。
| 名稱 | 描述 |
|---|---|
Cookieless |
讀取/寫入 sint32 列舉，指定是否要使用 Web 應用程式的 Cookie。 可能的值稍後會列在一節中。 |
CookieName |
讀取/寫入 string 值，指定指派給 Cookie 的名稱。 預設值為 「。ASPXANONYMOUS」。 |
CookiePath |
讀取/寫入 string 值，指定儲存 Cookie 之目錄的路徑。 預設值為根目錄，由 「/」 指定。 |
CookieProtection |
指定 Cookie 保護設定的讀取/寫入 sint32 列舉。 可能的值稍後會列在一節中。 |
CookieRequireSSL |
讀取/寫入 boolean 值。 true 如果 Cookie 在傳送至用戶端時需要安全通訊端層 (SSL) 連線，則為 ;否則為 false 。 預設值為 false。設定 ASP.NET Secure 驗證 Cookie 屬性時，只有在使用 SSL 連線時，用戶端才會傳回 Cookie。 |
CookieSlidingExpiration |
必要的讀取/寫入 boolean 值。 true 如果 Cookie 到期最初設定為目前的日期和時間加上 屬性中的 CookieTimeout 分鐘值，則為 ， false 否則為 。 預設值為 true。如果 true 為 ，則會在 中的 CookieTimeout 值少於一半且使用者仍在使用應用程式時，自動重新整理 Cookie 的到期日期和時間。 如果 false 為 ，則 Cookie 會在 屬性中指定的 CookieTimeout 間隔通過之後自動逾時。 如需詳細資訊，請參閱 System.Web.HttpCookie.Expires 屬性。 |
CookieTimeout |
指定 Cookie 到期時間間隔的必要讀取/寫入 datetime 值。 預設值為 69 天、10 小時和 40 分鐘，相當於 10000 分鐘。 |
Domain |
指定 Cookie 網域的讀取/寫入 string 值。 預設為空字串 ("")。此屬性允許跨具有通用網域名稱系統 (DNS) (命名空間的網域共用匿名識別 Cookie，例如，以 「contoso.com」 ) 結尾的所有網站。 若要共用匿名識別 Cookie，網站必須共用一般解密和驗證金鑰。 其他匿名識別組態屬性，例如 Cookie 路徑和 Cookie 名稱，對於所有網站都必須相同。 如需詳細資訊，請參閱 System.Web.HttpCookie 類別。 |
Enabled |
選擇性的讀取/寫入 boolean 值。 如果啟用匿名識別則為 true，否則為 false。 如果 true 為 ，則會使用 cookie (或無 Cookie 值) 來管理使用者的匿名識別碼。 預設值為 false。 |
Location |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
Path |
(繼承自 ConfigurationSection .) 索引鍵屬性。 |
SectionInformation |
(繼承自 ConfigurationSection。) |
子類別
這個類別不包含子類別。
備註
下表列出 屬性的可能值 Cookieless 。 預設值為 1 (UseCookies) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | UseUri |
指定不論瀏覽器或裝置是否支援 Cookie，呼叫功能都會使用查詢字串來儲存識別碼。 |
| 1 | UseCookies |
指定不論瀏覽器或裝置是否支援 Cookie，都會使用 Cookie 來保存使用者資料。 |
| 2 | AutoDetect |
指定 ASP.NET 判斷要求瀏覽器或裝置是否支援 Cookie。 如果要求瀏覽器或裝置支援 Cookie， AutoDetect 請使用 Cookie 來保存使用者資料，否則會在查詢字串中使用識別碼。 如果瀏覽器或裝置支援 Cookie，但 Cookie 目前已停用，要求功能仍會使用 Cookie。 |
| 3 | UseDeviceProfile |
指定 ASP.NET 判斷是否根據 System.Web.Configuration.HttpCapabilitiesBase.Cookies 屬性使用 Cookie。 如果此設定指示，瀏覽器或裝置有支援 Cookie，則會使用 Cookie，否則，會在查詢字串中使用識別項。 |
下表列出 屬性的可能值 CookieProtection 。 預設值為 1 (Validation) 。
| 值 | 關鍵字 | 描述 |
|---|---|---|
| 0 | None |
指定 Cookie 資訊未受到保護。 Cookie 中的資訊會以純文字儲存，而且不會在資訊傳回伺服器時進行驗證。 |
| 1 | Validation |
在資訊傳回伺服器之前，請確定 Cookie 中的資訊尚未改變。 |
| 2 | Encryption |
加密 Cookie 中的資訊。 |
| 3 | All |
指定 Validation 和 Encryption 值都用來保護 Cookie 中的資訊。 |
繼承階層架構
AnonymousIdentificationSection
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 檔案 | WebAdministration.mof |
另請參閱
System.Web.Configuration.SystemWebSectionGroup.AnonymousIdentification System.Web.HttpCookie.Expires
System.Web.HttpCookie.Secure
System.Web.HttpCookie System.Web.HttpCookieMode ConfigurationSection 類別
CIM_DATETIME