ClientTargetSection クラス

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

ClientTargetSection クラス

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

clientTarget セクションを構成します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 ClientTargetSection
    Inherits ConfigurationSection

Visual Basic (使用法)

Dim instance As ClientTargetSection

C#

public sealed class ClientTargetSection : ConfigurationSection

C++

public ref class ClientTargetSection sealed
 : public ConfigurationSection

J#

public final class ClientTargetSection extends
 ConfigurationSection

JScript

public final class ClientTargetSection extends
 ConfigurationSection

解説

ClientTargetSection クラスを使用すると、構成ファイルの clientTarget セクションにプログラムからアクセスして変更できます。これは、ClientTargetCollection クラスと ClientTarget クラスを含むグループの一部です。

ClientTargetSection クラスは、ClientTarget オブジェクトを格納します。このオブジェクトは、エイリアスのペア、および ASP.NET サーバー コントロールがコンテンツの表示対象とする関連付けられたターゲット ユーザー エージェントを定義します。

メモ
ClientTargetSection は、値が Everywhere のセクション プロパティ AllowDefinition に従って、構成ファイル内の関連するセクションから情報を読み込んだり、このセクションに情報を書き込んだりできます。

使用例

このセクションには、2 つのコード例が用意されています。最初の例では、ClientTargetSection クラスの宣言による表現を示します。また、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.Configuration.ConfigurationSection
      System.Web.Configuration.ClientTargetSection

スレッド セーフ

この型の 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

参照

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