Page.ClientTarget プロパティ

[アーティクル]
06/26/2007

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

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

構文

'宣言
Public Property ClientTarget As String
'使用
Dim instance As Page
Dim value As String

value = instance.ClientTarget

instance.ClientTarget = value

public string ClientTarget { get; set; }

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

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

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

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 Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

その他の技術情報

ASP.NET Web サーバーコントロールとブラウザの機能
 clientTarget 要素 (ASP.NET 設定スキーマ)

Share via