AmbientPropertyValue Třída

Definice

Obor názvů:

System.Xaml

Sestavení:

System.Xaml.dll

Hlásí informace o okolí vlastnosti v rámci 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 položku informací vrácenou voláním IAmbientProvider metody služby. Metody GetAll vracejí výčty nebo pole AmbientPropertyValue položek; GetFirst metody vracejí jeden AmbientPropertyValue.

O okolních vlastnostech

Okolí 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 objektový graf pod ním. Okolní koncept je relevantní pro procesor XAML během fáze zápisu objektu cesty načtení nebo fáze serializace cesty uložení.

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

V případě cesty načtení může hodnota okolní vlastnosti ovlivnit graf objektů vygenerované hodnoty jiných vlastností, které pod ní existují ve struktuře uzlu XAML. Při zpracování jako stream uzlu XAML, okolí koncept znamená, že okolní hodnota vlastnosti musí být k dispozici pro převaděče typů a rozšíření značek z StartObject do EndObject. Podobně může převaděč typů nebo rozšíření značek, které se používá pro cestu uložení vyhledat okolí vlastnost a jeho hodnotu. Proto je produkovaný XAML lepší reprezentací odezvy.

V definici jazyka xaml neurčí pořadí, ve kterém musí být členové objektu zpracovány. Jakákoli hodnota okolní vlastnosti však musí být nejprve zpracována čtenářem XAML, aby převaděč typů a rozšíření značek, které jsou obsaženy v jiných vlastnostech, mohou k němu přistupovat prostřednictvím IAmbientProvider služby.

DependsOn je podobný koncept, který také ovlivňuje pořadí zpracování uzlů XAML. DependsOn Lze však 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 okolní technika spoléhá na převaděče typů nebo rozšíření značek. V okolí techniky musí existovat také konkrétní převaděč typů nebo definice rozšíření značek. Je až do každého převaděče typů nebo rozšíření značek určit, jak má být hodnota okolní vlastnosti interpretována a použita v 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ář okolní vlastnosti, který je znázorněn v sadě funkcí WPF je Style.TargetType, který může opravovat potřebné vyhledávání názvu vlastnosti pro jiné hodnoty. V tomto případě Style.TargetType tato hodnota kvalifikuje Setter.Property hodnoty v uzlech XAML pod ní. Setter.Propertypoužívá chování převaděče typů pro .DependencyProperty Toto chování přistupuje k okolí Style.TargetType hodnoty dotazováním GetFirstAmbientValue z kontextu služby, který je k dispozici pro převaděče typů a rozšíření značek.

Konstruktory

Name	Description
AmbientPropertyValue(XamlMember, Object)	Inicializuje novou instanci AmbientPropertyValue třídy.

Vlastnosti

Name	Description
RetrievedProperty	Získá identifikátor systému typu XAML (XamlMember), který představuje okolí vlastnost.
Value	Získá hodnotu okolí vlastnost.

Viz také

• IAmbientProvider