次の方法で共有


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

更新 : 2007 年 11 月

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

<configuration> 要素
  system.web 要素 (ASP.NET 設定スキーマ)
    clientTarget 要素 (ASP.NET 設定スキーマ)

<clientTarget> 
   <add... />
   <remove... />
   <clear/>
</clientTarget>

属性と要素

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

属性

なし。

子要素

要素

説明

add

省略可能な要素

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

clear

省略可能な要素

指定した Web.config ファイルに現在格納されているか、指定した Web.config ファイルから継承したすべてのエイリアスを削除します。

remove

省略可能な要素

特定の 1 つのユーザー エージェントのエイリアスをユーザー エージェント エイリアスの内部コレクションから削除します。値は、先行する add ディレクティブの値と正確に一致する必要があります。ワイルドカードを使った選択はサポートされていません。

親要素

要素

説明

configuration

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

system.web

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

解説

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

既定の構成

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

<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 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

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

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

使用例

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

構成メンバ

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

構成できる場所

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

Visual Studio 2003 または Visual Studio 2005

参照

処理手順

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

概念

ASP.NET 構成の概要

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

ASP.NET 構成の保護

ASP.NET の構成のシナリオ

参照

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

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

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

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

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

@ Page

System.Configuration

System.Web.Configuration

その他の技術情報

ASP.NET 構成ファイル

ASP.NET 構成設定

全般構成設定 (ASP.NET)

ASP.NET 構成 API