PropertyPath.Path Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur string yang menjelaskan jalur.

public:
 property System::String ^ Path { System::String ^ get(); void set(System::String ^ value); };

public string Path { get; set; }

member this.Path : string with get, set

Public Property Path As String

Nilai Properti

String

String yang menjelaskan jalur.

Keterangan

String yang terkandung dalam properti ini memiliki tiga arti yang sama sekali berbeda tergantung pada apakah PropertyPath sedang digunakan untuk jalur properti mode sumber untuk pengikatan, untuk jalur properti langkah tunggal mode target untuk target papan cerita, atau untuk jalur kompleks untuk target papan cerita.

Jika menggunakan ini PropertyPath dalam mode sumber untuk pengikatan, Path adalah string yang mewakili nama properti, atau dapat menjadi string yang menjelaskan jalur "langkah-melalui" ke properti dalam model objek CLR objek yang digunakan sebagai sumber untuk pengikatan. Untuk jalur properti pengikatan, karakter yang mengidentifikasi "langkah" adalah titik (.). Referensi pengindeks (termasuk beberapa pengindeks, dan diferensiasi jenis) juga didukung. Untuk detail selengkapnya tentang sintaks string seperti yang secara khusus digunakan oleh Binding objek, lihat Binding.Path. Properti yang digunakan sebagai sumber pengikatan tidak perlu menjadi properti dependensi. Jika pengikatan diperbarui dua arah, sumber properti harus baca-tulis. Perhatikan juga bahwa target pengikatan memang harus menjadi properti dependensi. Untuk detailnya, lihat Gambaran Umum Pengikatan Data .

Jika menggunakan ini PropertyPath dalam mode target untuk jalur satu langkah untuk target papan cerita, PropertyPath adalah string yang merupakan typeName.string nama properti dependensi yang memenuhi syarat propertyName.

Jika menggunakan ini PropertyPath untuk jalur kompleks untuk target papan cerita, Path adalah format string yang ditokenisasi yang menjelaskan hubungan berbagai objek yang diberikan dalam PathParameters.

• Setiap item dalam array ditentukan dalam format ini oleh indeks array untuk item yang diapit dalam tanda kurung. Misalnya, untuk menentukan item pertama dalam array, token string adalah (0).

• Hubungan antara item ("langkah" di jalur) ditentukan oleh titik (.). Properti maju dari titik adalah langkah pertama di jalur, properti setelah adalah langkah kedua, dan sebagainya (Anda dapat menentukan langkah-langkah di luar dua). Langkah terakhir dalam rantai selalu mewakili properti yang dianimasikan.

• Item dalam properti koleksi diakses dengan sintaks pengindeks, dengan indeks dalam tanda kurung siku ([ dan ]). Pengindeks bersifat tambahan pada token yang mewakili properti . Misalnya, berikut ini adalah jalur dua langkah, dengan kombinasi token di langkah pertama yang menentukan item kedua dari dalam kumpulan properti tersebut: (0)[1].(1) . Anda tidak dapat menggunakan pengindeks pada properti terakhir dalam rantai; Anda tidak dapat menganimasikan posisi koleksi yang sebenarnya, Anda harus menganimasikan properti pada objek tersebut.

String jalur untuk PropertyPath biasanya dibuat melalui konstruktor: PropertyPath(Object) tanda tangan untuk pengikatan atau target papan cerita langkah tunggal, PropertyPath(String, Object[]) tanda tangan untuk target papan cerita multi-langkah.

XAML: Saat Anda menggunakan PropertyPath untuk menjelaskan referensi properti di XAML, sebagai nilai atribut, string yang Anda tentukan pertama kali ditangani oleh pengonversi jenis (PropertyPathConverter). Pengonversi jenis ini kemudian memproses string dan berdasarkan sintaksnya akan memanggil salah PropertyPath satu tanda tangan konstruktor. Indirection melalui pengonversi jenis yang menangani nilai atribut umumnya adalah cara Anda menggunakan PropertyPath di XAML, daripada mendeklarasikan PropertyPath elemen objek dan kemudian menerapkan nilai tertentu ke atribut seperti Path dan PathParameters. Untuk informasi selengkapnya, lihat Sintaks PropertyPath XAML.

Penggunaan Teks XAML

Anggota jenis PropertyPath biasanya tidak diatur dalam sintaks XAML langsung. Lihat Komentar.