ClientTarget 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義與目標使用者代理相關聯的別名,ASP.NET 伺服器控制應該渲染內容。 無法繼承這個類別。
public ref class ClientTarget sealed : System::Configuration::ConfigurationElement
public sealed class ClientTarget : System.Configuration.ConfigurationElement
type ClientTarget = class
inherit ConfigurationElement
Public 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.ClientTarget 屬性, HttpBrowserCapabilities 與該 Page.Request 屬性相關的物件會反映客戶端瀏覽器的功能。 (它反映瀏覽器類型的功能,但不一定代表該瀏覽器特定實例的設定。)若設定了該屬性,客戶端瀏覽器偵測會被停用,頁面會使用與你定義的使用者代理字串相關的瀏覽器功能。 你可以將此屬性設定為任何有效的使用者代理字串。
建構函式
| 名稱 | Description |
|---|---|
| ClientTarget(String, String) |
初始化 ClientTarget 類別的新執行個體。 |