use Element for browserCaps (ASP.NET Settings Schema)

Article
11/03/2006

Specifies the HTTP request string that are used to parse the browser capability information that is stored in the filter and case elements.

Note
Using the browserCaps element in the Web.config file to define browsers is deprecated in the .NET Framework 2.0 but is still supported. The data in this element is merged with the information from the browser definition files (.browser) that are located in the machine-level %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers folder and any existing application-level App_Browsers folders. For more information, see Browser Definition File Schema (browsers Element).

Using the browserCaps element in the Web.config file to define browsers is deprecated in the .NET Framework 2.0 but is still supported. The data in this element is merged with the information from the browser definition files (.browser) that are located in the machine-level %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers folder and any existing application-level App_Browsers folders. For more information, see Browser Definition File Schema (browsers Element).

<use 
   var="server variable" 
   as="variableName"
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
var	Optional String attribute. Specifies the Microsoft Internet Information Services (IIS) server variable that is parsed to extract browser capability information. The default is "HTTP_USER_AGENT".
as	Optional String attribute. Specifies a name that can be used to reference the server variable in subsequent regular expressions.

var

Optional String attribute.

Specifies the Microsoft Internet Information Services (IIS) server variable that is parsed to extract browser capability information.

The default is "HTTP_USER_AGENT".

Optional String attribute.

Specifies a name that can be used to reference the server variable in subsequent regular expressions.

Child Elements

None.

Parent Elements

Element	Description
configuration	The required root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
system.web	Specifies the root element for the ASP.NET configuration settings in a configuration file and contains configuration elements that configure ASP.NET Web applications and control how the applications behave.
browserCaps	Specifies the settings of supported browsers and the capabilities for the browsers. This element can be updated as required to specify new browsers and capabilities. For a list of valid browser properties, see HttpBrowserCapabilities.

configuration

The required root element in every configuration file that is used by the common language runtime and the .NET Framework applications.

system.web

Specifies the root element for the ASP.NET configuration settings in a configuration file and contains configuration elements that configure ASP.NET Web applications and control how the applications behave.

browserCaps

Specifies the settings of supported browsers and the capabilities for the browsers. This element can be updated as required to specify new browsers and capabilities.

For a list of valid browser properties, see HttpBrowserCapabilities.

Remarks

The use element specifies the HTTP request string that is used to parse the browser capability information that is stored in the filter and case elements.

Default Configuration

In the .NET Framework version 2.0, the use element is not configured because the browserCaps element is deprecated in favor of using browser definition files to specify supported browsers and the capabilities for the browsers. For more information, see Browser Definition File Schema (browsers Element).

In the .NET Framework versions 1.0 and 1.1, the default use elements that are configured in the Machine.config file are too numerous to list here. For updates to the browser data, go to cyScape, Inc. at http://www.cyscape.com/browsercaps. Periodic device updates replace this browser capabilities section.

Example

The following code example demonstrates how to specify that the IIS HTTP_USER_AGENT server variable is the source of the browser capabilities information.

<use var="HTTP_USER_AGENT">

Element Information

Configuration section handler	HttpCapabilitiesSectionHandler
Configuration member	Browsers
Configurable locations	Machine.config Root-level Web.config Application-level Web.config Virtual or physical directory–level Web.config
Requirements	Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 2.0 (deprecated), 1.1, or 1.0 Microsoft Visual Studio 2003 or Visual Studio 2005

Partager via

use Element for browserCaps (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Default Configuration

Example

Element Information

See Also

Tasks

Reference

Concepts

Other Resources

Ressources supplémentaires