Page.ClientTarget 屬性

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

取得或設定數值，讓您覆寫瀏覽器能力的自動偵測，並指定網頁在特定瀏覽器用戶端要如何顯示。

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

[System.ComponentModel.Browsable(false)]
public string ClientTarget { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.ClientTarget : string with get, set

Public Property ClientTarget As String

屬性值

String

String，指定您要覆寫的瀏覽器能力。

屬性

BrowsableAttribute

範例

下列程式代碼範例會 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>  

備註

如果您未設定 ClientTarget 屬性， HttpBrowserCapabilities 與屬性相關聯的 Page.Request 物件會反映客戶端瀏覽器的功能。 如果您設定此屬性，則會停用用戶端瀏覽器偵測，而且頁面會使用與您提供之值 (別名) 相關聯的瀏覽器功能。

Web 伺服器電腦上的根 Web.config 組態檔會定義下列預設別名，您可以做為常見使用者代理程式字串的縮寫：

• uplevel，指定相當於 Internet Explorer 6.0 的瀏覽器功能。

• downlevel，指定相當於不支援用戶端文本之舊版瀏覽器的瀏覽器功能。 您可以使用此別名來判斷網頁在已停用用戶端文本的瀏覽器中的運作方式。

您可以使用這個屬性以程式設計方式設定別名，或使用 @ Page 指示詞的 屬性以宣告方式ClientTarget設定別名。

您可以在應用層級 Web.config 檔案的 區段中定義其他別名 clientTarget 。 如需詳細資訊，請參閱 clientTarget 元素 (ASP.NET 設定架構) 。

另請參閱

• HttpBrowserCapabilities
• Browser
• UserAgent
• ASP.NET 伺服器控制件和瀏覽器功能
• ASP.NET 組態檔