次の方法で共有


browserCaps の use 要素 (ASP.NET 設定スキーマ)

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

filter 要素および case 要素に格納されているブラウザー機能情報の解析に使用する HTTP 要求文字列を指定します。

注意

Web.config ファイル内で browserCaps 要素を使用してブラウザーを定義する方法は、.NET Framework 2.0 では使用されませんが、サポートは継続しています。この要素内のデータは、コンピューター レベルの %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers フォルダーおよびアプリケーション レベルのすべての App_Browsers フォルダーに配置されているブラウザー定義ファイル (.browser) の情報とマージされます。詳細については、「ブラウザー定義ファイルのスキーマ (browsers 要素)」を参照してください。

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

Description

var

省略可能な String 型の属性です。

ブラウザー機能情報を抽出するために解析される Microsoft Internet Information Services (IIS) サーバー変数を指定します。

既定値は、"HTTP_USER_AGENT" です。

as

省略可能な String 型の属性です。

後続の正規表現と共に使うことができる、サーバー変数を参照するために使用する名前を指定します。

子要素

なし。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。

browserCaps

サポートされているブラウザーの設定およびブラウザーの機能を指定します。 この要素は、新しいブラウザーとその機能を指定するために、必要に応じて更新できます。

有効なブラウザー プロパティの一覧については、「HttpBrowserCapabilities」を参照してください。

解説

use 要素は、filter 要素および case 要素に格納されているブラウザー機能情報の解析に使用する HTTP 要求文字列を指定します。

既定の構成

.NET Framework Version 2.0 では、サポートされているブラウザーとその機能の指定に browserCaps 要素を使用することは推奨されていません。代わりにブラウザー定義ファイルが使用されるため、use 要素は設定されません。 詳細については、「ブラウザー定義ファイルのスキーマ (browsers 要素)」を参照してください。

.NET Framework Version 1.0 および Version 1.1 では、Machine.config ファイルで構成される既定の use 要素が非常に多いため、ここでは示しません。 ブラウザー データの更新については、cyScape, Inc. の Web サイト (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 Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 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

Reference

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