AmbientPropertyValue Sınıf

Tanım

Ad Alanı:

System.Xaml

Bütünleştirilmiş Kod:

System.Xaml.dll

Bir uygulamanın parçası IAmbientProvider olarak bir ortam özelliği hakkındaki bilgileri raporlar.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Devralma

Object

AmbientPropertyValue

Açıklamalar

AmbientPropertyValue bir hizmet yöntemi çağrılarak döndürülen bir IAmbientProvider bilgi öğesini temsil eder. GetAll Yöntemler sabit listeleri veya öğe dizileri AmbientPropertyValue döndürür; GetFirst yöntemler tek AmbientPropertyValuebir döndürür.

Ortam Özellikleri Hakkında

Ortam özelliği, özellik değerinin XAML düğüm yapısında değer dönüştürücüsü kullanımı ve altındaki nesne grafı için kullanılabilir olması gereken bir özelliktir. Ortam kavramı, yük yolunun nesne yazma aşamasında veya bir kaydetme yolunun serileştirme aşamasında bir XAML işlemcisi için geçerlidir.

Bir tür ortam olarak da ilişkilendirilebilir. Bu durumda, öznitelikli türü kullanan tüm özellikler ortam olarak bildirilir.

Yük yolu örneğinde, ortam özellik değeri nesne grafının XAML düğüm yapısında altında bulunan diğer özelliklerin değerini üretmesini etkileyebilir. Bir XAML düğümü akışı olarak işlendiğinde, ortam kavramı, ortam özelliği değerinin türünde dönüştürücüler ve işaretleme uzantıları için 'den StartObjectEndObjectöğesine kullanılabilir olması gerektiğini gösterir. Benzer şekilde, kaydetme yolu için kullanılan bir tür dönüştürücüsü veya işaretleme uzantısı ortam özelliğini ve değerini arayabilir. Bu nedenle, üretilen XAML daha iyi bir gidiş dönüş gösterimidir.

XAML, dil tanımına göre bir nesnenin üyelerinin işlenme sırasını belirtmez. Bununla birlikte, diğer özelliklerde yer alan tür dönüştürücüsü ve işaretleme uzantısı kullanımının hizmet aracılığıyla IAmbientProvider erişebilmesi için tüm ortam özellik değerlerinin önce XAML okuyucusu tarafından işlenmesi gerekir.

DependsOn XAML düğüm işleme sırasını da etkileyen benzer bir kavramdır. Ancak, DependsOn yalnızca eş üye ve düğüm ilişkileri için kullanılabilir; tüm alt öğeleri etkileyemez. Ayrıca, DependsOn ortam tekniği tür dönüştürücülerine veya işaretleme uzantılarına dayanırken nesne grafı özellik ayarını doğrudan etkiler. Ortam tekniğinde, belirli bir tür dönüştürücüsü veya işaretleme uzantısı tanımı da olmalıdır. Ortam özelliği değerinin nasıl yorumlanması ve tür dönüştürücüsü veya işaretleme uzantısının kullanıldığı nesne grafı konumuna uygulanması gerektiğini belirlemek için her tür dönüştürücü veya işaretleme uzantısına bağlıdır.

WPF Kullanım Notları

WPF özellik kümesinde gösterilen bir ortam özelliği senaryosu, Style.TargetTypediğer değerler için gerekli özellik adı aramalarını niteleyebilir. Bu durumda, Style.TargetType değer altındaki XAML düğümlerindeki değerleri niteler Setter.Property . Setter.Property , için DependencyPropertytür dönüştürücü davranışını kullanır. Bu davranış, tür dönüştürücüleri ve işaretleme uzantıları için kullanılabilen bir hizmet bağlamından sorgu yaparak GetFirstAmbientValue ortam Style.TargetType değerine erişir.

Oluşturucular

Name	Description
AmbientPropertyValue(XamlMember, Object)	AmbientPropertyValue sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
RetrievedProperty	Ortam özelliğini temsil eden XAML türü sistem tanımlayıcısını (XamlMember) alır.
Value	Ambient özelliğinin değerini alır.

Ayrıca bkz.

• IAmbientProvider