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

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

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

<browserCaps>
   <result />
   <use />
   [browser capability property assignments]
   <filter>...</filter>
</browserCaps>

属性および要素

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

属性

子要素

親要素

解説

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

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

形式 capsVariableName=regular expression の行は、代入式です。 構文 %{capsVariableName} または ${captureGroupName} を match 属性および代入式の右側で使用します。

正規表現の使用方法の詳細については、「.NET Framework の正規表現」を参照してください。 この構文の詳細な例を含む完全な browserCaps セクションについては、.NET Framework と共にインストールされる Machine.config ファイルを参照してください。

capsVariableName と共にキャプチャされた名前と値のペアには、HttpCapabilitiesBase クラスから継承される HttpBrowserCapabilities オブジェクトの Item プロパティを使用してアクセスできます。 Item プロパティは、C# での既定のインデクサー プロパティです。

既定の構成

.NET Framework Version 2.0 では、サポートされているブラウザーとその機能の指定にブラウザー定義ファイルを使用するために、browserCaps 要素の使用は推奨されていません。そのため、次のような制限付きの既定の browserCaps 要素がルートの Web.config ファイルで構成されます。 詳細については、「ブラウザー定義ファイルのスキーマ (browsers 要素)」を参照してください。

<browserCaps userAgentCacheKeyLength="64">
   <result 
      type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
   />
</browserCaps>

.NET Framework Versions 1.0 および 1.1 では、machine.config ファイルで構成される既定の browserCaps 要素が、ここに示せないほどの大きさになります。 ブラウザー データの更新については、http://www.cyscape.com/browsercaps を参照してください。 定期的なデバイスの更新により、このブラウザー機能セクションが置き換えられます。

使用例

任意のバージョンの Internet Explorer に対する User-Agent HTTP ヘッダーを解析する方法を次のコード例に示します (User-Agent 文字列の形式がほとんど変更されていない場合に限ります)。

この例では、.NET Framework の正規表現と、部分式をキャプチャできる正規表現の機能を利用して、バージョン番号を User-Agent 文字列から HttpBrowserCapabilities オブジェクトに直接移動しています。

このファイルでは、Microsoft Internet Information Services (IIS) の browscap.ini ファイルと同様の代入ステートメントの形式で、名前と値のペアを指定します。 たとえば、"browser=IE" という行は、browser フィールドの値を "IE" という文字列に設定します。

<configuration>
 <system.web>
   <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>
 </system.web>
</configuration>

要素情報

参照

処理手順

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

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

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

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

browserCaps の use 要素 (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