browserCaps 的 use 元素(ASP.NET 设置架构)
[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
指定 HTTP 请求字符串,该字符串用于分析存储在 filter 和 case 元素中的浏览器功能信息。
备注
使用 Web.config 文件中的 browserCaps 元素来定义浏览器在 .NET Framework 2.0 中被否决,但仍受支持。此元素中的数据与浏览器定义文件 (.browser) 中的信息合并在一起,这些文件位于计算机级别的 %SystemRoot%\Microsoft.NET\Framework\版本\CONFIG\Browsers 文件夹以及任何现有的应用程序级别的 App_Browsers 文件夹中。有关更多信息,请参见浏览器定义文件架构(browsers 元素)。
<use
var="server variable"
as="variableName"
/>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
---|---|
var |
可选的 String 特性。 指定 Microsoft Internet 信息服务 (IIS) 服务器变量,通过对它进行分析来提取浏览器功能信息。 默认值为 "HTTP_USER_AGENT"。 |
as |
可选的 String 特性。 指定在后面的正则表达式中可用于引用服务器变量的名称。 |
子元素
无。
父元素
元素 |
说明 |
---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素,并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。 |
browserCaps |
指定支持的浏览器的设置及其功能。 可以根据需要更新该元素以指定新的浏览器及功能。 若要查看有效浏览器属性的列表,请参见 HttpBrowserCapabilities。 |
备注
use 元素指定 HTTP 请求字符串,该字符串用于分析存储在 filter 和 case 元素中的浏览器功能信息。
默认配置
在 .NET Framework 2.0 版中,未配置 use 元素,因为 browserCaps 元素已被否决,并改为使用浏览器定义文件来指定受支持的浏览器及其功能。 有关更多信息,请参见浏览器定义文件架构(browsers 元素)。
在 .NET Framework 1.0 和 1.1 版中,Machine.config 文件中配置的默认 use 元素太多,恕不在此列出。 要获得浏览器数据的更新,请访问 cyScape, Inc. 网站, 网址为 http://www.cyscape.com/browsercaps。 定期设备更新将替代浏览器功能的此部分。
示例
下面的代码示例演示如何指定 IIS HTTP_USER_AGENT 服务器变量是浏览器功能信息的源。
<use var="HTTP_USER_AGENT">
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
要求 |
Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 版本 2.0(已否决)、1.1 或 1.0 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
How to: Detect Browser Types in ASP.NET Web Pages
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
browserCaps 的 filter 元素(ASP.NET 设置架构)
browserCaps 的 result 元素(ASP.NET 设置架构)
HttpCapabilitiesSectionHandler
概念
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy