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 1 つ 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)

適用対象

こちらもご覧ください