共用方式為


ClientTarget 類別

定義

定義與目標使用者代理相關聯的別名,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 類別的新執行個體。

屬性

名稱 Description
Alias

取得使用者代理的別名。

CurrentConfiguration

會取得代表該Configuration實例所屬配置階層的頂層ConfigurationElement實例參考。

(繼承來源 ConfigurationElement)
ElementInformation

取得 ElementInformation 一個包含不可自訂資訊與功能的 ConfigurationElement 物件。

(繼承來源 ConfigurationElement)
ElementProperty

取得 ConfigurationElementProperty 代表該 ConfigurationElement 物件本身的物件。

(繼承來源 ConfigurationElement)
EvaluationContext

取得 ContextInformation 物件的 ConfigurationElement 物件。

(繼承來源 ConfigurationElement)
HasContext

獲得一個表示該 CurrentConfiguration 性質是否為 null的值。

(繼承來源 ConfigurationElement)
Item[ConfigurationProperty]

取得或設定此組態元素的屬性或屬性。

(繼承來源 ConfigurationElement)
Item[String]

取得或設定該配置元素的屬性、屬性或子元素。

(繼承來源 ConfigurationElement)
LockAllAttributesExcept

取得鎖定屬性的集合。

(繼承來源 ConfigurationElement)
LockAllElementsExcept

獲得鎖定元素的集合。

(繼承來源 ConfigurationElement)
LockAttributes

取得鎖定屬性的集合。

(繼承來源 ConfigurationElement)
LockElements

獲得鎖定元素的集合。

(繼承來源 ConfigurationElement)
LockItem

取得或設定一個值,表示該元素是否被鎖定。

(繼承來源 ConfigurationElement)
Properties

取得一組房產。

(繼承來源 ConfigurationElement)
UserAgent

取得使用者代理的識別名稱。

方法

名稱 Description
DeserializeElement(XmlReader, Boolean)

從設定檔讀取 XML。

(繼承來源 ConfigurationElement)
Equals(Object)

將目前 ConfigurationElement 實例與指定的物件進行比較。

(繼承來源 ConfigurationElement)
GetHashCode()

會獲得代表當前 ConfigurationElement 實例的唯一值。

(繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)

回傳指定的組裝名稱轉換後版本。

(繼承來源 ConfigurationElement)
GetTransformedTypeString(String)

回傳指定型別名稱的轉換後版本。

(繼承來源 ConfigurationElement)
GetType()

取得目前實例的 Type

(繼承來源 Object)
Init()

將物件設定 ConfigurationElement 為初始狀態。

(繼承來源 ConfigurationElement)
InitializeDefault()

用於初始化物件的預設值 ConfigurationElement 集合。

(繼承來源 ConfigurationElement)
IsModified()

表示此組態元素自最後儲存或載入後是否被修改,且實作於衍生類別中。

(繼承來源 ConfigurationElement)
IsReadOnly()

會取得一個值,表示該物件是否 ConfigurationElement 為唯讀。

(繼承來源 ConfigurationElement)
ListErrors(IList)

將此 ConfigurationElement 物件及所有子元素中的無效屬性錯誤加入已傳遞的清單中。

(繼承來源 ConfigurationElement)
MemberwiseClone()

建立目前 Object的淺層複本。

(繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)

獲得一個值,表示在反序列化過程中是否遇到未知屬性。

(繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

會獲得一個值,表示在反序列化過程中是否遇到未知元素。

(繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)

當找不到所需的屬性時,會拋出例外。

(繼承來源 ConfigurationElement)
PostDeserialize()

在解序後被呼叫。

(繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)

在序列號之前就被打過。

(繼承來源 ConfigurationElement)
Reset(ConfigurationElement)

重置物件的 ConfigurationElement 內部狀態,包括鎖與屬性集合。

(繼承來源 ConfigurationElement)
ResetModified()

在導出類別實作時,將方法的值IsModified()重置為 。false

(繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

當在衍生類別中實作時,會將此組態元素的內容寫入設定檔。

(繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

當在衍生類別中實作時,會將此組態元素的外部標籤寫入設定檔。

(繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

將屬性設定為指定的值。

(繼承來源 ConfigurationElement)
SetReadOnly()

設定 IsReadOnly() 物件及所有子元素的 ConfigurationElement 屬性。

(繼承來源 ConfigurationElement)
ToString()

傳回表示目前 物件的字串。

(繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

修改物件 ConfigurationElement 以移除所有不應儲存的值。

(繼承來源 ConfigurationElement)

適用於

另請參閱