ClientTarget クラス

定義

ASP.NET サーバー コントロールによるコンテンツ表示の対象となるターゲット ユーザー エージェントに関連付けられているエイリアスを定義します。 このクラスは継承できません。

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
継承

このセクションでは、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 クラスの新しいインスタンスを初期化します。

プロパティ

Alias

ユーザー エージェントのエイリアスを取得します。

CurrentConfiguration

現在の Configuration インスタンスが属している構成階層を表す最上位の ConfigurationElement インスタンスへの参照を取得します。

(継承元 ConfigurationElement)
ElementInformation

ElementInformation オブジェクトのカスタマイズできない情報と機能を格納する ConfigurationElement オブジェクトを取得します。

(継承元 ConfigurationElement)
ElementProperty

ConfigurationElementProperty オブジェクト自体を表す ConfigurationElement オブジェクトを取得します。

(継承元 ConfigurationElement)
EvaluationContext

ContextInformation オブジェクトの ConfigurationElement オブジェクトを取得します。

(継承元 ConfigurationElement)
HasContext

CurrentConfiguration プロパティが null であるかどうかを示す値を取得します。

(継承元 ConfigurationElement)
Item[ConfigurationProperty]

この構成要素のプロパティまたは属性を取得または設定します。

(継承元 ConfigurationElement)
Item[String]

この構成要素のプロパティ、属性、または子要素を取得または設定します。

(継承元 ConfigurationElement)
LockAllAttributesExcept

ロックされている属性のコレクションを取得します。

(継承元 ConfigurationElement)
LockAllElementsExcept

ロックされている要素のコレクションを取得します。

(継承元 ConfigurationElement)
LockAttributes

ロックされている属性のコレクションを取得します。

(継承元 ConfigurationElement)
LockElements

ロックされている要素のコレクションを取得します。

(継承元 ConfigurationElement)
LockItem

要素がロックされているかどうかを示す値を取得または設定します。

(継承元 ConfigurationElement)
Properties

プロパティのコレクションを取得します。

(継承元 ConfigurationElement)
UserAgent

ユーザー エージェントの識別名を取得します。

メソッド

DeserializeElement(XmlReader, Boolean)

構成ファイルから XML を読み取ります。

(継承元 ConfigurationElement)
Equals(Object)

現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。

(継承元 ConfigurationElement)
GetHashCode()

現在の ConfigurationElement インスタンスを表す一意の値を取得します。

(継承元 ConfigurationElement)
GetTransformedAssemblyString(String)

指定されたアセンブリ名を変換して返します。

(継承元 ConfigurationElement)
GetTransformedTypeString(String)

指定された型名を変換して返します。

(継承元 ConfigurationElement)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
Init()

ConfigurationElement オブジェクトを初期状態に設定します。

(継承元 ConfigurationElement)
InitializeDefault()

ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。

(継承元 ConfigurationElement)
IsModified()

派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。

(継承元 ConfigurationElement)
IsReadOnly()

ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。

(継承元 ConfigurationElement)
ListErrors(IList)

この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。

(継承元 ConfigurationElement)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnDeserializeUnrecognizedAttribute(String, String)

逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。

(継承元 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。

(継承元 ConfigurationElement)
OnRequiredPropertyNotFound(String)

必要なプロパティが見つからないと例外がスローされます。

(継承元 ConfigurationElement)
PostDeserialize()

逆シリアル化後に呼び出されます。

(継承元 ConfigurationElement)
PreSerialize(XmlWriter)

シリアル化前に呼び出されます。

(継承元 ConfigurationElement)
Reset(ConfigurationElement)

ConfigurationElement オブジェクトの内部状態 (ロックやプロパティ コレクションなど) をリセットします。

(継承元 ConfigurationElement)
ResetModified()

IsModified() メソッドの値が派生クラスに実装されたときに、false にリセットします。

(継承元 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。

(継承元 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。

(継承元 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

プロパティを指定した値に設定します。

(継承元 ConfigurationElement)
SetReadOnly()

IsReadOnly() オブジェクトおよびすべてのサブ要素に ConfigurationElement プロパティを設定します。

(継承元 ConfigurationElement)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。

(継承元 ConfigurationElement)

適用対象

こちらもご覧ください