browserCaps の filter 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
この要素は、個々の設定を特定のブラウザー定義に適用できる検索文字列の一覧を指定します。
注意
Web.config ファイル内で browserCaps 要素を使用してブラウザーを定義する方法は、.NET Framework Version 2.0 では使用されませんが、サポートは継続しています。この要素内のデータは、コンピューター レベルの %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers フォルダーおよびアプリケーション レベルのすべての App_Browsers フォルダーに配置されているブラウザー定義ファイル (.browser) の情報とマージされます。詳細については、「ブラウザー定義ファイルのスキーマ (browsers 要素)」を参照してください。
<filter>
[assignments, filter elements and case elements]
<filter>
<filter
match="[regular expression]"
with="[regular expression]" >
[browser capability assignments, filter elements, case elements]
</filter>
<filter>
<case>...</case>
</filter>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
match |
省略可能な String 型の属性です。 with 属性に対して照合される .NET Framework 正規表現を指定します。 この属性を省略すると、正常な一致が検出されたと見なされます。 |
with |
省略可能な String 型の属性です。 検索対象の .NET Framework 正規表現または文字列を指定します。 この属性を省略すると、use 要素で指定された文字列が使用されます。 |
子要素
要素 |
Description |
|---|---|
case |
多数の候補の中から最初に検出された正常な一致を処理した後で、パターン一致を停止できるようにします。 |
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。 |
system.web |
構成ファイルの ASP.NET 構成設定のルート要素を指定します。ASP.NET Web アプリケーションを構成する構成要素やアプリケーションの動作を制御する構成要素が含まれます。 |
browserCaps |
サポートされているブラウザーの設定およびブラウザーの機能を指定します。 browserCaps 要素は、新しいブラウザーとその機能を指定するために、必要に応じて更新できます。 有効なブラウザー プロパティの一覧については、「HttpBrowserCapabilities」を参照してください。 |
解説
browserCaps 要素は、個々の設定を特定のブラウザー定義に適用できる検索文字列の一覧を指定します。 一覧に含まれる規則は順番に適用されます。 一致する最初の case 子要素が評価され、残りの子 case 子要素は無視されます。
既定の構成
.NET Framework Version 2.0 では、サポートされているブラウザーとその機能の指定に browserCaps 要素を使用することは推奨されていません。代わりにブラウザー定義ファイルが使用されるため、filter 要素は設定されません。 詳細については、「ブラウザー定義ファイルのスキーマ (browsers 要素)」を参照してください。
.NET Framework Version 1.0 および Version 1.1 では、Machine.config ファイルで構成される既定の filter 要素が非常に多いため、ここでは示しません。 ブラウザー データの更新については、http://www.cyscape.com/browsercaps を参照してください。 定期的なデバイスの更新により、このブラウザー機能セクションが置き換えられます。
使用例
任意のバージョンの Internet Explorer に対する User-Agent HTTP ヘッダーを解析する方法を次のコード例に示します (User-Agent 文字列の形式がほとんど変更されていない場合に限ります)。
この例では、.NET Framework の正規表現と、部分式をキャプチャできる正規表現の機能を利用して、バージョン番号を User-Agent 文字列から browserCaps 要素に直接移動しています。
このファイルでは、Microsoft Internet Information Services (IIS) の browscap.ini ファイルと同様の代入ステートメントの形式で、名前と値のペアを指定します。 たとえば、"browser=IE" という行は、browser フィールドの値を "IE" という文字列に設定します。
<configuration>
<browserCaps>
<result type="System.Web.HttpBrowserCapabilities, System.Web"/>
<use var="HTTP_USER_AGENT"/>
browser=Unknown
version=0.0
majorversion=0
minorversion=0
frames=false
tables=false
cookies=false
backgroundsounds=false
<filter>
<case match="^Mozilla[^(]*\(compatible; MSIE
(?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
(?'extra'.*)">
browser=IE
version=${ver}
majorver=${major}
minorver=${minor}
<case match="^2\." with="%{version}">
tables=true
cookies=true
backgroundsounds=true
<case match="2\.5b" with="%{version}">
beta=true
</case>
</case>
</case>
</filter>
</browsercaps>
</configuration>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
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.0、または 1.1 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 設定スキーマ)
browserCaps の filter の case 要素 (ASP.NET 設定スキーマ)
system.web 要素 (ASP.NET 設定スキーマ)
browserCaps の result 要素 (ASP.NET 設定スキーマ)
browserCaps の use 要素 (ASP.NET 設定スキーマ)
ブラウザー定義ファイルのスキーマ (browsers 要素)
HttpCapabilitiesSectionHandler
概念
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy