ClientTarget クラス
アセンブリ: System.Web (system.web.dll 内)
構文
解説
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 オブジェクトを取得する方法を次のコード例に示します。
' 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
// 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.Configuration.ConfigurationElement
System.Web.Configuration.ClientTarget
プラットフォーム
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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
- ClientTarget クラスのページへのリンク