ClientTarget 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
定義與目標使用者代理程式相關聯的別名 (ASP.NET 伺服器控制項應當為此代理程式呈現內容)。 此類別無法獲得繼承。
public ref class ClientTarget sealed : System::Configuration::ConfigurationElementpublic sealed class ClientTarget : System.Configuration.ConfigurationElementtype ClientTarget = class
inherit ConfigurationElementPublic NotInheritable Class ClientTarget
Inherits ConfigurationElement- 繼承
範例
本節提供兩個程式代碼範例。 第一個示範如何宣告方式指定類別數個 ClientTarget 屬性的值。 第二個顯示如何從組態檔取得 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 包含兩個識別用戶端瀏覽器的屬性，也稱為使用者代理程式。 其中一個屬性是與第二個屬性所識別之用戶端瀏覽器相關聯的別名。 ASP.NET 使用此資訊來轉譯頁面中的伺服器控件。
如需如何以程序設計方式使用使用者代理程式或其別名的資訊，請參閱 Page.ClientTarget 屬性。 如需如何以宣告方式使用使用者代理程式或其別名的相關信息，請參閱 @ Page。
Page.ClientTarget如果未設定屬性，HttpBrowserCapabilities則與 Page.Request 屬性相關聯的物件會反映客戶端瀏覽器的功能。 (它會反映瀏覽器類型的功能，但不一定是該 browser 的特定實例中的設定。) 如果已設定 屬性，則會停用用戶端瀏覽器偵測，而且頁面會使用與您定義之使用者代理程式字元串相關聯的瀏覽器功能。 您可以將此屬性設定為任何有效的使用者代理程式字串。
建構函式
| ClientTarget(String, String) |
初始化 ClientTarget 類別的新執行個體。 |
