AmbientPropertyValue Třída

Definice

Obor názvů:

System.Xaml

Sestavení:

System.Xaml.dll

Sestavuje informace o vlastnosti okolí jako součást IAmbientProvider implementace.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Dědičnost

Object

AmbientPropertyValue

Poznámky

AmbientPropertyValue představuje informační položku, která je vrácena voláním IAmbientProvider metody služby. Metody GetAll vracejí výčty nebo pole AmbientPropertyValue položek; GetFirst metody vrací jeden AmbientPropertyValue.

O okolních vlastnostech

Okolní vlastnost je vlastnost, jejíž hodnota vlastnosti by měla být k dispozici pro použití převaděče hodnot ve struktuře uzlu XAML a v grafu objektů pod ní. Koncept okolí je relevantní pro procesor XAML během fáze zápisu objektu v cestě načítání nebo ve fázi serializace cesty uložení.

Typ může být také přiřazen jako okolní. V tomto případě jsou všechny vlastnosti, které používají atributový typ, hlášeny jako okolní.

V případě cesty načtení může hodnota vlastnosti okolí ovlivnit hodnotu objektu grafu vytvořenou jinými vlastnostmi, které existují pod ní ve struktuře uzlu XAML. Při zpracování jako stream uzlu XAML koncept okolí znamená, že hodnota vlastnosti okolí musí být k dispozici pro převaděče typů a rozšíření značek od StartObject do EndObject. Podobně převaděč typů nebo rozšíření značek, které se používá pro cestu uložení, může vyhledat okolí vlastnost a její hodnotu. Proto xaml, který se vytvoří, je lepší reprezentace odezvy.

Ve své definici jazyka XAML neurčil pořadí, ve kterém se musí členové objektu zpracovávat. Jakákoli hodnota okolní vlastnosti však musí být nejprve zpracována čtečkou XAML, aby převaděč typů a použití rozšíření značek, které jsou obsaženy v jiných vlastnostech, mělo přístup prostřednictvím IAmbientProvider služby.

DependsOn je podobný koncept, který také ovlivňuje pořadí zpracování uzlů XAML. Lze však DependsOn použít pouze pro vztahy mezi členy partnerského vztahu a uzly; nemůže ovlivnit všechny potomky. DependsOn Také přímo ovlivňuje nastavení vlastností grafu objektů, zatímco technika okolí spoléhá na převaděče typů nebo rozšíření značek. V okolní technice musí existovat také konkrétní typ převaděče nebo definice rozšíření značek. Je na každém převaděči typů nebo rozšíření značek, aby určili, jak se má interpretovat hodnota okolní vlastnosti a aplikovat na umístění grafu objektu, kde se používá převaděč typů nebo rozšíření značek.

Poznámky k využití WPF

Scénář vlastností okolí, který je znázorněn v sadě funkcí WPF, je Style.TargetType, který může kvalifikovat potřebné vyhledávání názvů vlastností pro jiné hodnoty. V tomto případě Style.TargetType hodnota kvalifikuje Setter.Property hodnoty v uzlech XAML pod ní. Setter.Property používá chování převaděče typů pro DependencyProperty. Toto chování přistupuje k okolní Style.TargetType hodnotě dotazováním GetFirstAmbientValue z kontextu služby, který je k dispozici pro převaděče typů a rozšíření značek.

Konstruktory

AmbientPropertyValue(XamlMember, Object)

Inicializuje novou instanci AmbientPropertyValue třídy.

Vlastnosti

RetrievedProperty	Získá xaml typ identifikátor systému (XamlMember), který představuje okolí vlastnost.
Value	Získá hodnotu ambientní vlastnosti.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• IAmbientProvider