clientTarget の add 要素 (ASP.NET 設定スキーマ)

特定の 1 つのユーザー エージェントのエイリアスをユーザー エージェント エイリアスの内部コレクションに追加します。

<add alias="alias for user agent" 
     userAgent="user agent identification"/>

属性および要素

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

属性

属性

説明

alias

必須の属性です。

特定のユーザー エージェントを参照するために使用される名前を指定します。

userAgent

必須の属性です。

ユーザー エージェントの ID を指定します。

子要素

なし。

親要素

要素

説明

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。

system.web

ASP.NET 構成セクションのルート要素を指定します。

clientTarget

特定の複数のユーザー エージェントのエイリアスをユーザー エージェント エイリアスの内部コレクションに追加します。

解説

ユーザー エージェント エイリアスのコレクションは、ASP.NET サーバー コントロールが内容を表示する対象となる複数のユーザー エージェントを示します。

既定の構成

次の既定の add 要素は、.NET Framework Version 2.0 においてルートの Web.config ファイルで構成されています。

<add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
<add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
<add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
<add alias="downlevel" userAgent="Generic Downlevel" />

次の既定の add 要素は、.NET Framework Version 1.0 および 1.1 の Machine.config ファイルで構成されます。

<add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
<add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
<add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
<add alias="downlevel" userAgent="Unknown"/>

使用例

4 つのユーザー エージェント エイリアスを内部ユーザー エージェント エイリアス コレクションに追加する方法を次のコード例に示します。

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible; 
                     MSIE 5.5; Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible; 
                     MSIE 4.0; Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; 
                     MSIE 4.0; Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

要素情報

構成セクション ハンドラー

System.Web.Configuration.ClientTargetSection

構成メンバー

Add

構成できる場所

Machine.config

ルート レベルの Web.config

アプリケーション レベルの Web.config

仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config

要件

Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0

.NET Framework Version 1.0、1.1、または 2.0

Microsoft Visual Studio 2003 または Visual Studio 2005

参照

処理手順

方法 : ASP.NET 構成設定をロックする

参照

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

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

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

clientTarget の clear 要素 (ASP.NET 設定スキーマ)

clientTarget の remove 要素 (ASP.NET 設定スキーマ)

@ Page

System.Configuration

System.Web.Configuration

概念

ASP.NET 構成の概要

ASP.NET Web サーバー コントロールとブラウザーの機能

ASP.NET 構成の保護

ASP.NET の構成のシナリオ

その他の技術情報

ASP.NET 構成ファイル

ASP.NET 構成設定

全般構成設定 (ASP.NET)

ASP.NET 構成 API