AmbientPropertyValue 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
報告有關環境物業的資訊,作為實施的一部分 IAmbientProvider 。
public ref class AmbientPropertyValue
public class AmbientPropertyValue
type AmbientPropertyValue = class
Public Class AmbientPropertyValue
- 繼承
-
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 此行為透過從Style.TargetType可供型別轉換器與標記擴充的服務上下文查詢GetFirstAmbientValue環境值。
建構函式
| 名稱 | Description |
|---|---|
| AmbientPropertyValue(XamlMember, Object) |
初始化 AmbientPropertyValue 類別的新執行個體。 |
屬性
| 名稱 | Description |
|---|---|
| RetrievedProperty |
取得代表環境屬性的 XAML 系統識別碼(XamlMember)類型。 |
| Value |
取得環境財產的價值。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |