针对应用程序授权配置匿名标识。这是在需要授权时，对没有经过身份验证的实体进行标识所必需的。
此元素是 .NET Framework 2.0 版中的新元素。
configuration 元素（常规设置架构）??system.web 元素（ASP.NET 设置架构）
????anonymousIdentification 元素（ASP.NET 设置架构）
<anonymousIdentification enabled="[true | false]" cookieless="[UseUri | UseCookies | AutoDetect | UseDeviceProfile]" cookieName="" cookiePath="" cookieProtection="[None | Validation | Encryption | All]" cookieRequireSSL="[true | false]" cookieSlidingExpiration="[true | false]" cookieTimeout="[DD.HH:MM:SS]" domain="cookie domain" /> |
属性和元素
下面几部分描述了属性、子元素和父元素。
属性
| 属性 | 说明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
cookieless |
指定对于 Web 应用程序是否使用 Cookie。HttpCookieMode 枚举用于在配置节中指定该属性的值。它由支持无 Cookie 身份验证的所有功能使用。指定 此属性可以为下列可能值之一。
默认值为 "UseCookies"。 |
||||||||||
|
cookieName |
指定分配给 Cookie 的名称。 默认值为 ".ASPXANONYMOUS"。 |
||||||||||
|
cookiePath |
指定存储 Cookie 的目录的路径。路径区分大小写。 默认值为 "/" 指定的根目录。 |
||||||||||
|
cookieProtection |
指定 Cookie 保护方案。 此属性可以为下列可能值之一。
默认值为 "Validation"。 |
||||||||||
|
cookieReuireSSL |
指定将 Cookie 传输到客户端时是否需要 SSL 连接。因为 ASP.NET 设置身份验证 Cookie 属性 默认值为 false。 |
||||||||||
|
cookieSlidingExpiration |
必选的 指定 Cookie 超时是在每次请求时重置还是按预定义的固定时间间隔重置。如果为 true，则剩余的 TTL 少于 50％ 时 Cookie 超时。如果为 false，则 cookieTimeout 持续时间过后 Cookie 超时。 默认值为 true。 |
||||||||||
|
cookieTimeout |
必选的 指定 Cookie 过期时间间隔（以分钟为单位）。 默认值为 10000 分钟（69 天 10 小时 40 分钟）。 |
||||||||||
|
domain |
指定 Cookie 域。使用此属性可以在具有共同 DNS 命名空间的域（例如，以 contoso.com 结尾的所有站点）之间共享匿名标识 Cookie。若要共享匿名标识 Cookie，这些站点必须共享相同的解密和验证密钥。所有站点的其他匿名标识配置属性（如 Cookie 路径和 Cookie 名称）必须相同。有关更多信息，请参见 默认值为空字符串 ("")。 |
||||||||||
|
enabled |
可选的 Boolean 属性。 指定是否启用匿名标识。如果为 true，则使用 Cookie（或没有 Cookie 的值）来管理用户的匿名标识符。 默认值为 false。 |
子元素
无。
父元素
| 元素 | 说明 |
|---|---|
|
configuration |
指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
|
system.web |
指定配置文件中 ASP.NET 配置设置的根元素，并且包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
备注
anonymousIdentification 元素针对应用程序授权配置匿名标识。这是在使用“配置文件”功能时，对没有经过身份验证的实体进行标识所必需的。
在 URI 中发送匿名标识票时，可以超过 URI 的最大大小。如果匿名标识票、Forms 身份验证票、会话 ID 和用户数据的组合超出允许的最大 URI 长度，则请求会失败并显示“400-Bad Request”错误。
默认配置
下面的默认 anonymousIdentification 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的。但是，它是应用程序返回的默认配置。
| ? |  复制代码 |
|---|---|
<anonymousIdentification enabled="false" cookieName=".ASPXANONYMOUS" cookieTimeout="100000" cookiePath="/" cookieRequireSSL="false" cookieSlidingExpiration="true" cookieProtection="Validation" cookieless="UseCookies" domain="" /> | |
示例
下面的代码示例演示如何为匿名标识配置站点。
| ? | 复制代码 |
|---|---|
<configuration>
<system.web>
<anonymousIdentification
enabled="true"
useCookies="true"
cookieName=".ASPXANONYMOUS
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration = "true"
cookieProtection="Clear"
/>
</system.web>
</configuration> | |
元素信息
|
配置节处理程序 |
|
|
配置成员 |
|
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config |
|
要求 |
Microsoft Internet 信息服务 (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
参考
system.web 元素（ASP.NET 设置架构）configuration 元素（常规设置架构）
概念
其他资源
常规配置设置 (ASP.NET)ASP.NET 配置设置
