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">
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
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 設定スキーマ)
browserCaps の filter 要素 (ASP.NET 設定スキーマ)
browserCaps の result 要素 (ASP.NET 設定スキーマ)
ブラウザー定義ファイルのスキーマ (browsers 要素)
HttpCapabilitiesSectionHandler
概念
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy