AmbientPropertyValue Kelas

Definisi

Ruang nama:

System.Xaml

Rakitan:

System.Xaml.dll

Melaporkan informasi tentang properti sekitar, sebagai bagian IAmbientProvider dari implementasi.

public ref class AmbientPropertyValue

public class AmbientPropertyValue

type AmbientPropertyValue = class

Public Class AmbientPropertyValue

Warisan

Object

AmbientPropertyValue

Keterangan

AmbientPropertyValue mewakili item informasi yang dikembalikan dengan memanggil IAmbientProvider metode layanan. Metode GetAll mengembalikan enumerasi atau array AmbientPropertyValue item; GetFirst metode mengembalikan satu AmbientPropertyValue.

Tentang Properti Sekitar

Properti sekitar adalah properti yang nilai propertinya harus tersedia untuk nilai penggunaan pengonversi dalam struktur simpul XAML dan ke grafik objek di bawahnya. Konsep sekitar relevan untuk prosesor XAML selama fase penulisan objek jalur beban atau fase serialisasi jalur penyimpanan.

Jenis juga dapat dikaitkan sebagai sekitar. Dalam hal ini, semua properti yang menggunakan jenis atribut dilaporkan sebagai sekitar.

Dalam kasus jalur beban, nilai properti sekitar mungkin memengaruhi nilai grafik objek yang dihasilkan dari properti lain yang ada di bawahnya dalam struktur simpul XAML. Ketika diproses sebagai aliran simpul XAML, konsep sekitar menyiratkan bahwa nilai properti sekitar harus tersedia untuk mengetik pengonversi dan ekstensi markup dari StartObject ke EndObject. Demikian pula, pengonversi jenis atau ekstensi markup yang digunakan untuk jalur penyimpanan dapat mencari properti sekitar dan nilainya. Oleh karena itu, XAML yang diproduksi adalah representasi pulang pergi yang lebih baik.

Dengan definisi bahasanya, XAML tidak menentukan urutan di mana anggota objek harus diproses. Namun, nilai properti sekitar apa pun harus diproses terlebih dahulu oleh pembaca XAML sehingga jenis konverter dan penggunaan ekstensi markup yang terkandung dalam properti lain dapat mengaksesnya melalui IAmbientProvider layanan.

DependsOn adalah konsep serupa yang juga memengaruhi urutan pemrosesan simpul XAML. Namun, DependsOn hanya dapat digunakan untuk hubungan anggota serekan dan simpul; itu tidak dapat memengaruhi semua keturunan. Selain itu, DependsOn secara langsung memengaruhi pengaturan properti grafik objek, sedangkan teknik sekitar bergantung pada pengonversi jenis atau ekstensi markup. Dalam teknik sekitar, juga harus ada jenis konverter tertentu atau definisi ekstensi markup. Terserah setiap jenis pengonversi atau ekstensi markup untuk menentukan bagaimana nilai properti sekitar harus ditafsirkan dan diterapkan ke lokasi grafik objek tempat konverter jenis atau ekstensi markup digunakan.

Catatan Penggunaan WPF

Skenario properti sekitar yang diilustrasikan dalam kumpulan fitur WPF adalah Style.TargetType, yang dapat memenuhi syarat pencarian nama properti yang diperlukan untuk nilai lain. Dalam hal ini, Style.TargetType nilai memenuhi syarat Setter.Property nilai dalam simpul XAML di bawahnya. Setter.Property menggunakan perilaku pengonversi jenis untuk DependencyProperty. Perilaku ini mengakses nilai sekitar dengan mengkueri Style.TargetTypeGetFirstAmbientValue dari konteks layanan yang tersedia untuk mengetik konverter dan ekstensi markup.

Konstruktor

Nama	Deskripsi
AmbientPropertyValue(XamlMember, Object)	Menginisialisasi instans baru dari kelas AmbientPropertyValue.

Properti

Nama	Deskripsi
RetrievedProperty	Mendapatkan pengidentifikasi sistem jenis XAML (XamlMember) yang mewakili properti sekitar.
Value	Mendapatkan nilai properti sekitar.

Lihat juga

• IAmbientProvider