Page.ClientTarget プロパティ

.NET Framework クラス ライブラリ リファレンス

Page.ClientTarget プロパティ

ブラウザの自動検出機能をオーバーライドし、ページが特定のブラウザ クライアントでどのように表示されるかを指定できるようにする値を取得または設定します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property ClientTarget As
 String

Visual Basic (使用法)

Dim instance As Page
Dim value As String

value = instance.ClientTarget

instance.ClientTarget = value

C#

public string ClientTarget { get;
 set; }

C++

public:
property String^ ClientTarget {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_ClientTarget ()

/** @property */
public void set_ClientTarget (String value)

JScript

public function get ClientTarget
 () : String

public function set ClientTarget
 (value : String)

プロパティ値
オーバーライドするブラウザ機能を指定する String。

解説

ClientTarget プロパティを設定しない場合、Page.Request プロパティに関連付けられた HttpBrowserCapabilities オブジェクトがクライアント ブラウザの機能を反映します。このプロパティを設定すると、クライアント ブラウザの検出機能が無効になり、ページは、指定したエイリアスと関連付けられたブラウザ機能を使用します。特に、ユーザー エージェントは、エイリアスごとに定義されます。

Web サーバー コンピュータの構成ファイル (Web.config) により、一般的なユーザー エージェント文字列の代わりに使用できる 4 つの既定のエイリアスが定義されます。これらの既定値は、ie5、ie4、uplevel、downlevel の 4 つです。ie5 は Internet Explorer 5.5 ブラウザ、ie4 は Internet Explorer 4.0 ブラウザ、uplevel は Internet Explorer 4.0 以降、downlevel は Internet Explorer 4.0 より前のブラウザに対応したページをそれぞれカスタマイズするときに使用します。

エイリアス文字列は、このプロパティを使用してプログラムによって設定したり、@ Page ディレクティブの ClientTarget 属性を使用して宣言によって設定したりできます。ページがブラウザに送信する応答を、4 つの既定のエイリアスに加え、さらに別のエイリアスを使用するようにカスタマイズする場合は、アプリケーション レベルの構成ファイル (Web.config) の<clientTarget> セクションで新しいエイリアスを定義し、そのエイリアスにこのプロパティを設定します。詳細については、「ASP.NET 構成の概要」を参照してください。

使用例

ie302 エイリアスを定義して、アプリケーションを構成するために必要なセクションを Web.config ファイルに挿入するコード例を次に示します。このエイリアスを使用すると、ClientTarget プロパティを ie302 に設定して Internet Explorer 3.02 ブラウザに対応するようにページをカスタマイズできます。

 <configuration>
   <system.web>
    <clientTarget>
     <add alias="ie302" useragent="Mozilla/2.0 (compatible; MSIE 3.02; Windows
 NT 3.5)" />
    </clientTarget>
   </system.web>
 </configuration>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Page クラス
Page メンバ
System.Web.UI 名前空間
HttpBrowserCapabilities
Browser
UserAgent
その他の技術情報
ASP.NET Web サーバー コントロールとブラウザの機能
clientTarget 要素 (ASP.NET 設定スキーマ)