Share via


clientTarget 項目 (ASP.NET 設定結構描述)

更新:2007 年 11 月

加入特定使用者代理程式的別名至使用者代理程式別名的內部集合。

<configuration> 項目
  system.web 項目 (ASP.NET 設定結構描述)
    clientTarget 項目 (ASP.NET 設定結構描述)

 <clientTarget>     <add... />    <remove... />    <clear/> </clientTarget>

屬性和項目

下列小節描述屬性、子項目和父項目。

屬性

無。

子項目

項目

描述

add

選擇性項目。

加入特定使用者代理程式的別名至使用者代理程式別名的內部集合。

clear

選擇性項目。

移除目前由指定的 Web.config 檔案所包含,或繼承自其中的所有別名。

remove

選擇性項目。

從使用者代理程式別名的內部集合移除特定使用者代理程式的別名。值必須完全符合先前 add 指示詞的值。不支援萬用字元選擇。

父項目

項目

描述

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。

system.web

指定 ASP.NET 組態區段的根項目。

備註

使用者代理程式別名的集合指示 ASP.NET 伺服器控制項應該轉譯其內容的目標使用者代理程式。

預設的組態

下列預設的 clientTarget 項目是在 .NET Framework 2.0 版中的根 Web.config 檔中設定。

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

在 .NET Framework 1.0 和 1.1 版中,下列預設 clientTarget 項目是設定在 Machine.config 檔案中。

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="downlevel" userAgent="Unknown"/>
</clientTarget>

範例

下列程式碼範例示範如何新增四個使用者代理程式別名。

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible;MSIE 5.5;Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

項目資訊

組態區段處理常式

System.Web.Configuration.ClientTargetSection

組態成員

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

可設定的位置

Machine.config

根層次的 Web.config

應用程式層級的 Web.config

虛擬或實體目錄層級的 Web.config

需求

Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版

.NET Framework 1.0、1.1 或 2.0 版

Microsoft Visual Studio 2003 或 Visual Studio 2005

請參閱

工作

HOW TO:鎖定 ASP.NET 組態設定

概念

ASP.NET 組態概觀

ASP.NET Web 伺服器控制項和瀏覽器能力

保護 ASP.NET 組態

ASP.NET 組態案例

參考

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

clientTarget 的 add 項目 (ASP.NET 設定結構描述)

clientTarget 的 clear 項目 (ASP.NET 設定結構描述)

clientTarget 的 remove 項目 (ASP.NET 設定結構描述)

@ Page

System.Configuration

System.Web.Configuration

其他資源

ASP.NET 組態檔

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET 組態 API