ClientTarget クラス

.NET Framework クラス ライブラリ リファレンス

ClientTarget クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET サーバー コントロールによるコンテンツ表示の対象となるターゲット ユーザー エージェントに関連付けられているエイリアスを定義します。このクラスは継承できません。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 ClientTarget
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As ClientTarget

C#

public sealed class ClientTarget : ConfigurationElement

C++

public ref class ClientTarget sealed : public
 ConfigurationElement

J#

public final class ClientTarget extends ConfigurationElement

JScript

public final class ClientTarget extends
 ConfigurationElement

解説

ClientTarget は、構成ファイルの clientTarget セクションの add 要素を参照します。

ClientTarget は、ClientTargetCollection クラスと ClientTargetSection クラスを含むグループの一部です。

ClientTarget クラスには、クライアント ブラウザ (ユーザー エージェントとも呼ばれます) を識別する 2 つのプロパティが格納されます。一方のプロパティは、他方のプロパティで識別されるクライアント ブラウザに関連付けられているエイリアスです。ASP.NET は、この情報を使用して、サーバー コントロールをページに表示します。

ユーザー エージェントまたはそのエイリアスをプログラムで使用する方法については ClientTarget のトピックを、宣言によって使用する方法については @ Page を、それぞれ参照してください。

ClientTarget プロパティを設定しない場合、Request プロパティに関連付けられた HttpBrowserCapabilities オブジェクトがクライアント ブラウザの機能を反映します。このプロパティを設定すると、クライアント ブラウザ検出が無効になり、ページは、定義したユーザー エージェント文字列に関連付けられたブラウザ機能を使用します。このプロパティは、有効な任意のエージェント文字列に設定できます。

使用例

このセクションには、2 つのコード例が用意されています。最初の例では、ClientTarget クラスの複数のプロパティに対して、宣言によって値を指定する方法を示しています。次の例では、ClientTargetCollection オブジェクトを構成ファイルから取得する方法を示しています。このオブジェクトは、それを格納している ClientTarget オブジェクトにアクセスする場合に使用します。

ClientTarget クラスの複数のプロパティに対して、宣言によって値を指定する方法を次のコード例に示します。

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

構成ファイルから ClientTargetCollection オブジェクトを取得する方法を次のコード例に示します。

Visual Basic

' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")

' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)

' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets

C#

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnetTest");

// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
  (ClientTargetSection)configuration.GetSection(
  "system.web/clientTarget");


// Get the client target collection.
ClientTargetCollection clientTargets =
  clientTargetSection.ClientTargets;

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.ClientTarget

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ClientTarget メンバ
System.Web.Configuration 名前空間
ClientTargetSection
ClientTargetCollection
ClientTarget
その他の技術情報
clientTarget 要素 (ASP.NET 設定スキーマ)
@ Page
ASP.NET Web サーバー コントロールとブラウザの機能