AmbientPropertyValue 類別

定義

命名空間:

System.Xaml

組件:

System.Xaml.dll

報告環境屬性的相關資訊，做為 IAmbientProvider 實作的一部分。

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

繼承

Object

AmbientPropertyValue

備註

AmbientPropertyValue 表示呼叫 IAmbientProvider 服務方法所傳回的資訊專案。 方法 GetAll 會傳回專案的列舉或陣列 AmbientPropertyValue ; GetFirst 方法會傳回單 AmbientPropertyValue 一 。

關於環境屬性

環境屬性是屬性，其屬性值應該可用於 XAML 節點結構中的值轉換器使用方式，以及其下方的物件圖形。 環境概念在載入路徑的物件寫入階段或儲存路徑的序列化階段期間，與 XAML 處理器有關。

類型也可以屬性化為環境。 在此情況下，所有使用屬性類型的屬性都會回報為環境。

在載入路徑案例中，環境屬性值可能會影響物件圖形所產生的其他屬性值，這些屬性存在於 XAML 節點結構中。 當當做 XAML 節點資料流程處理時，環境概念表示環境屬性值必須可用於類型轉換器和標記延伸至 StartObject EndObject 。 同樣地，用於儲存路徑的類型轉換子或標記延伸可以查閱環境屬性及其值。 因此，產生的 XAML 是較佳的來回標記法。

根據語言定義，XAML 不會指定必須處理物件成員的順序。 不過，XAML 讀取器必須先處理任何環境屬性值，讓其他屬性中包含的類型轉換器和標記延伸使用方式可以透過 IAmbientProvider 服務存取它。

DependsOn 是也會影響 XAML 節點處理順序的類似概念。 不過， DependsOn 只能用於對等成員和節點關聯性;它無法影響所有子系。 此外， DependsOn 也會直接影響物件圖形屬性設定，而環境技術則依賴類型轉換器或標記延伸。 在環境技術中，也必須有特定的類型轉換器或標記延伸定義。 每個類型轉換器或標記延伸，決定環境屬性值應該如何解譯並套用至使用類型轉換器或標記延伸的物件圖形位置。

WPF 使用注意事項

WPF 功能集中說明的環境屬性案例是 Style.TargetType ，它可以限定其他值的必要屬性名稱查閱。 在此情況下， Style.TargetType 值會 Setter.Property 限定其下方 XAML 節點中的值。 Setter.Property 使用 的 DependencyProperty 型別轉換器行為。 此行為會從類型轉換器和標記延伸可用的服務內容查詢 GetFirstAmbientValue ，以存取環境 Style.TargetType 值。

建構函式

AmbientPropertyValue(XamlMember, Object)

初始化 AmbientPropertyValue 類別的新執行個體。

屬性

RetrievedProperty	取得表示環境屬性的 XAML 型別系統識別項 (XamlMember)。
Value	取得環境屬性的值。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• IAmbientProvider