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 設定されていない場合、 プロパティに HttpBrowserCapabilities 関連付 Page.Request けられている オブジェクトには、クライアント ブラウザーの機能が反映されます。 (ブラウザーの種類の機能が反映されますが、そのブラウザーの特定のインスタンスの設定は必ずしも反映されません)。プロパティが設定されている場合、クライアント ブラウザーの検出は無効になり、ページでは、定義したユーザー エージェント文字列に関連付けられているブラウザー機能が使用されます。 このプロパティは、任意の有効なユーザー エージェント文字列に設定できます。
コンストラクター
| ClientTarget(String, String) |
ClientTarget クラスの新しいインスタンスを初期化します。 |
プロパティ
メソッド
適用対象
こちらもご覧ください
.NET