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">

元素信息

配置节处理程序

HttpCapabilitiesSectionHandler

配置成员

Browsers

可配置的位置

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 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

browserCaps 的 filter 元素(ASP.NET 设置架构)

browserCaps 的 result 元素(ASP.NET 设置架构)

浏览器定义文件架构(browsers 元素)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

概念

ASP.NET Server Controls and Browser Capabilities

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration API