AmbientPropertyValue Klass

Definition

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Arv

Object

AmbientPropertyValue

Kommentarer

AmbientPropertyValue representerar ett informationsobjekt som returneras genom att anropa en IAmbientProvider tjänstmetod. Metoderna GetAll returnerar uppräkningar eller matriser med AmbientPropertyValue objekt. GetFirst Metoderna returnerar en enda AmbientPropertyValue.

Om omgivande egenskaper

En omgivande egenskap är en egenskap vars egenskapsvärde ska vara tillgängligt för värdekonverterarens användning i XAML-nodstrukturen och för objektdiagrammet under den. Det omgivande konceptet är relevant för en XAML-processor under objektskrivningsfasen för inläsningssökvägen eller serialiseringsfasen för en sparande sökväg.

En typ kan också tillskrivas som omgivande. I det här fallet rapporteras alla egenskaper som använder den tillskrivna typen som omgivande.

I inläsningssökvägsfallet kan värdet för den omgivande egenskapen påverka objektdiagrammets värde för andra egenskaper som finns under den i en XAML-nodstruktur. När det bearbetas som en XAML-nodström innebär det omgivande konceptet att värdet för den omgivande egenskapen måste vara tillgängligt för typkonverterare och markeringstillägg från StartObject till EndObject. På samma sätt kan en typkonverterare eller markeringstillägg som används för spara-sökvägen slå upp den omgivande egenskapen och dess värde. Därför är XAML som produceras en bättre återgivning tur och retur.

Enligt språkdefinitionen anger XAML inte i vilken ordning medlemmar i ett objekt måste bearbetas. Alla värden för omgivande egenskaper måste dock först bearbetas av XAML-läsaren så att typkonverteraren och markeringstilläggsanvändningen som finns i andra egenskaper kan komma åt det via IAmbientProvider tjänsten.

DependsOn är ett liknande begrepp som också påverkar XAML-nodbearbetningsordningen. Kan dock DependsOn endast användas för peer-medlems- och nodrelationer. Det kan inte påverka alla underordnade. DependsOn Påverkar också objektgrafegenskapsinställningen direkt, medan den omgivande tekniken förlitar sig på typkonverterare eller tillägg för markering. I den omgivande tekniken måste det också finnas en specifik typkonverterare eller en definition för markeringstillägg. Det är upp till varje typkonverterare eller markeringstillägg att avgöra hur värdet för den omgivande egenskapen ska tolkas och tillämpas på den objektgrafplats där typkonverteraren eller markeringstillägget används.

WPF-användningsanteckningar

Ett scenario med omgivande egenskaper som visas i WPF funktionsuppsättningen är Style.TargetType, vilket kan kvalificera nödvändiga egenskapsnamnsökningar för andra värden. I det här fallet Style.TargetType kvalificerar Setter.Property värdet värdena i XAML-noderna under det. Setter.Property använder typkonverterarens beteende för en DependencyProperty. Det här beteendet kommer åt det omgivande Style.TargetType värdet genom att GetFirstAmbientValue fråga från en tjänstkontext som är tillgänglig för att skriva konverterare och tillägg för markering.

Se även

• IAmbientProvider