AmbientPropertyValue Klas

Definitie

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Overname

Object

AmbientPropertyValue

Opmerkingen

AmbientPropertyValue vertegenwoordigt een informatie-item dat wordt geretourneerd door een IAmbientProvider servicemethode aan te roepen. De GetAll methoden retourneren opsommingen of matrices van AmbientPropertyValue items; de GetFirst methoden retourneren één AmbientPropertyValue.

Over omgevingseigenschappen

Een omgevingseigenschap is een eigenschap waarvan de eigenschapswaarde beschikbaar moet zijn voor waardeconversiegebruik in de XAML-knooppuntstructuur en voor de objectgrafiek eronder. Het omgevingsconcept is relevant voor een XAML-processor tijdens de objectschrijffase van het laadpad of de serialisatiefase van een opslagpad.

Een type kan ook worden toegeschreven als omgeving. In dit geval worden alle eigenschappen die gebruikmaken van het toegewezen type gerapporteerd als omgeving.

In het geval van het laadpad kan de waarde van de omgevingseigenschap van invloed zijn op de objectgrafiek die eronder bestaat in een XAML-knooppuntstructuur. Wanneer het wordt verwerkt als een XAML-knooppuntstroom, impliceert het omgevingsconcept dat de waarde van de omgevingseigenschap beschikbaar moet zijn om conversieprogramma's en markeringsextensies van StartObject tot EndObject. Op dezelfde manier kan een type converter of markeringsextensie die wordt gebruikt voor het opslagpad, de omgevingseigenschap en de bijbehorende waarde opzoeken. Daarom is de XAML die wordt geproduceerd een betere retourweergave.

Volgens de taaldefinitie geeft XAML niet de volgorde op waarin leden van een object moeten worden verwerkt. Elke waarde van de omgevingseigenschap moet echter eerst worden verwerkt door de XAML-lezer, zodat het type conversieprogramma en het gebruik van markeringsuitbreidingen die zijn opgenomen in andere eigenschappen, toegang hebben via de IAmbientProvider service.

DependsOn is een vergelijkbaar concept dat ook invloed heeft op de XAML-knooppuntverwerkingsvolgorde. Kan DependsOn echter alleen worden gebruikt voor peer-lid- en knooppuntrelaties. Het kan geen invloed hebben op alle afstammelingen. DependsOn Heeft ook rechtstreeks invloed op de instelling van objectgrafiekeigenschappen, terwijl de omgevingstechniek afhankelijk is van typeconversieprogramma's of markeringsextensies. In de omgevingstechniek moet er ook een specifieke typeconversie- of markeringsextensiedefinitie zijn. Het is aan elk type conversieprogramma of extensie voor markeringen om te bepalen hoe de waarde van de omgevingseigenschap moet worden geïnterpreteerd en toegepast op de locatie van de objectgrafiek waar het type conversieprogramma of de extensie voor markeringen wordt gebruikt.

Opmerkingen bij WPF-gebruik

Een omgevingseigenschapsscenario dat wordt geïllustreerd in de WPF functieset is Style.TargetType, die de benodigde eigenschapsnaamzoekacties voor andere waarden kan kwalificeren. In dit geval komt de Style.TargetType waarde in aanmerking voor de Setter.Property waarden in de XAML-knooppunten eronder. Setter.Property gebruikt het gedrag van het type conversieprogramma voor een DependencyProperty. Dit gedrag heeft toegang tot de omgevingswaarde door query's Style.TargetType uit te voeren GetFirstAmbientValue vanuit een servicecontext die beschikbaar is om conversieprogramma's en markeringsextensies te typen.

Zie ook

• IAmbientProvider