AnonymousIdentificationSection 类 1
指定如何在 Web 应用程序中使用 Cookie。
语法
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 值。 如果 Cookie 在传输到客户端时需要安全套接字层 (SSL) 连接，为 true；否则为 false。 默认为 false。设置了 ASP.NET Secure 身份验证 Cookie 属性时，仅当在使用 SSL 连接时，客户端才会返回该 Cookie。 |
CookieSlidingExpiration |
需要的读/写 boolean 值。 如果 Cookie 过期时间最初设置为当前日期和时间加上 CookieTimeout 属性中的值（以分钟为单位），为 true；否则为 false。 默认为 true。如果为 true，在 CookieTimeout 中的值还剩不到一半并且用户仍在主动使用应用程序的情况下，Cookie 的到期日期和时间将自动刷新。 如果为 false，Cookie 在经过 CookieTimeout 属性中指定的时间间隔后自动超时。 有关详细信息，请参阅 System.Web.HttpCookie.Expires 属性。 |
CookieTimeout |
需要的读/写 datetime 值，它指定 Cookie 过期时间间隔。 默认值为 69 天 10 小时 40 分钟，相当于 10000 分钟。 |
Domain |
一个读/写 string 值，它指定 Cookie 域。 默认值为空字符串("")。此属性允许跨具有通用域名系统 (DNS) 命名空间的域（例如，以“contoso.com”结尾的所有站点）共享匿名标识 Cookie。 若要共享匿名标识 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
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - 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