browserCaps の use 要素 (ASP.NET 設定スキーマ)
更新 : 2007 年 11 月
filter 要素および case 要素に格納されているブラウザ機能情報の解析に使用する HTTP 要求文字列を指定します。
.gif "メモ") メモ : |
|---|
Web.config ファイル内で browserCaps 要素を使用してブラウザを定義する方法は、.NET Framework 2.0 では使用されませんが、サポートは継続しています。この要素内のデータは、コンピュータ レベルの %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers フォルダおよびアプリケーション レベルのすべての App_Browsers フォルダに配置されているブラウザ定義ファイル (.browser) の情報とマージされます。詳細については、「ブラウザ定義ファイルのスキーマ (browsers 要素)」を参照してください。 |
configuration 要素 (全般設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
browserCaps 要素 (ASP.NET 設定スキーマ)
browserCaps の use 要素 (ASP.NET 設定スキーマ)
<use
var="server variable"
as="variableName"
/>
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
var |
省略可能な String 型の属性です。 ブラウザ機能情報を抽出するために解析される Microsoft Internet Information Services (IIS) サーバー変数を指定します。 既定値は "HTTP_USER_AGENT" です。 |
as |
省略可能な String 型の属性です。 後続の正規表現と共に使うことができる、サーバー変数を参照するために使用する名前を指定します。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
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 |
参照
処理手順
方法 : ASP.NET Web ページでブラウザの種類を検出する
方法 : Location の設定を使用して特定のディレクトリを構成する
概念
ASP.NET Web サーバー コントロールとブラウザの機能
参照
browserCaps 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
browserCaps の filter 要素 (ASP.NET 設定スキーマ)
browserCaps の result 要素 (ASP.NET 設定スキーマ)
HttpCapabilitiesSectionHandler