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ındaki değer dönüştürücü 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 durumunda, ortam özelliği 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 StartObject 'e EndObjectkullanı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ü veya işaretleme uzantısı tanımı da olmalıdır. Ortam özellik 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üye 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 değer, Style.TargetType 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 sorgulayarak GetFirstAmbientValue ortam Style.TargetType değerine erişir.

Oluşturucular

AmbientPropertyValue(XamlMember, Object)

AmbientPropertyValue sınıfının yeni bir örneğini başlatır.

Özellikler

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.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• IAmbientProvider