ClientTarget クラス

定義

public ref class ClientTarget sealed : System::Configuration::ConfigurationElement

public sealed class ClientTarget : System.Configuration.ConfigurationElement

type ClientTarget = class
    inherit ConfigurationElement

Public NotInheritable Class ClientTarget
Inherits ConfigurationElement

継承

Object

ConfigurationElement

ClientTarget

例

このセクションでは、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 けられている オブジェクトには、クライアント ブラウザーの機能が反映されます。 (ブラウザーの種類の機能が反映されますが、そのブラウザーの特定のインスタンスの設定は必ずしも反映されません)。プロパティが設定されている場合、クライアント ブラウザーの検出は無効になり、ページでは、定義したユーザー エージェント文字列に関連付けられているブラウザー機能が使用されます。 このプロパティは、任意の有効なユーザー エージェント文字列に設定できます。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• ClientTargetSection
• ClientTargetCollection
• ClientTarget
• ASP.NET サーバー コントロールとブラウザー機能