ClientTarget クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ASP.NET サーバー コントロールがコンテンツをレンダリングするターゲット ユーザー エージェントに関連付けられているエイリアスを定義します。 このクラスは継承できません。
public ref class ClientTarget sealed : System::Configuration::ConfigurationElementpublic sealed class ClientTarget : System.Configuration.ConfigurationElementtype ClientTarget = class
inherit ConfigurationElementPublic NotInheritable Class ClientTarget
Inherits ConfigurationElement- 継承
例
このセクションでは、2 つのコード例を示します。 1 つ目は、 ClientTarget クラスのいくつかのプロパティの値を宣言によって指定する方法を示しています。 2 つ目は、構成ファイルから ClientTargetCollection オブジェクトを取得する方法を示しています。 このオブジェクトを使用して、そのオブジェクトに含まれる ClientTarget オブジェクトにアクセスします。
次のコード例は、 ClientTarget クラスのいくつかのプロパティの値を宣言によって指定する方法を示しています。
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
次のコード例は、構成ファイルから ClientTargetCollection オブジェクトを取得する方法を示しています。
// 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;
' 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
注釈
ClientTarget クラスは、構成ファイルの clientTarget セクションに追加される要素を参照します。
ClientTarget クラスは、ClientTargetCollection クラスと ClientTargetSection クラスを含むグループに属しています。
ClientTarget クラスには、クライアント ブラウザーを識別する 2 つのプロパティ (名前付きユーザー エージェント) が含まれています。 1 つのプロパティは、2 番目のプロパティによって識別されるクライアント ブラウザーに関連付けられているエイリアスです。 ASP.NET は、この情報を使用して、ページ内のサーバー コントロールをレンダリングします。
ユーザー エージェントまたはそのエイリアスをプログラムで使用する方法については、 Page.ClientTarget プロパティを参照してください。 ユーザー エージェントまたはそのエイリアスを宣言的に使用する方法については、「 @ Page」を参照してください。
Page.ClientTarget プロパティが設定されていない場合、Page.Request プロパティに関連付けられているHttpBrowserCapabilities オブジェクトには、クライアント ブラウザーの機能が反映されます。 (ブラウザーの種類の機能が反映されますが、そのブラウザーの特定のインスタンスの設定は必ずしも反映されません)。プロパティが設定されている場合、クライアント ブラウザーの検出は無効になり、定義したユーザー エージェント文字列に関連付けられているブラウザー機能がページで使用されます。 このプロパティは、任意の有効なユーザー エージェント文字列に設定できます。
コンストラクター
| 名前 | 説明 |
|---|---|
| ClientTarget(String, String) |
ClientTarget クラスの新しいインスタンスを初期化します。 |
