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

属性

子要素

親要素

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>
   <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>

処理手順

関連項目

概念

その他の技術情報