Binding.ElementName Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nama elemen yang akan digunakan sebagai sumber pengikatan untuk Pengikatan.
public:
property Platform::String ^ ElementName { Platform::String ^ get(); void set(Platform::String ^ value); };winrt::hstring ElementName();
void ElementName(winrt::hstring value);public string ElementName { get; set; }var string = binding.elementName;
binding.elementName = string;Public Property ElementName As String<Binding ElementName="nameString"/>
Nilai Properti
Nilai properti Nama atau atribut x:Name untuk elemen yang ingin Anda gunakan sebagai sumber pengikatan. Defaultnya adalah string kosong.
Contoh
Contoh kode berikut menunjukkan cara membuat pengikatan dua arah antara TextBox dan kontrol Penggeser . Untuk daftar kode lengkap, lihat skenario 1 dalam sampel pengikatan data XAML.
<Slider x:Name="slider1" Minimum="1" Maximum="100"/>
<TextBox Text="{Binding ElementName=slider1, Path=Value, Mode=TwoWay}"/>
Keterangan
Saat Anda mengatur properti ini, nilai yang ditentukan harus merujuk ke elemen di salah satu lokasi berikut:
- Namescope XAML saat ini.
- Namescope XAML dari induk templat jika target pengikatan berada dalam templat data atau templat kontrol. Karena pembatasan ini, Anda tidak dapat menggunakan properti ElementName untuk mengikat elemen yang tidak dibuat dengan menggunakan XAML. Untuk mengikat elemen yang dibuat secara terprogram, gunakan properti Sumber sebagai gantinya. Sumber, RelativeSource, dan ElementName saling eksklusif dalam pengikatan. Jika Anda telah mengatur salah satu atribut ini, maka mengatur salah satu dari dua lainnya dalam pengikatan (melalui XAML atau melalui kode) akan menyebabkan pengecualian.
Pengikatan yang menggunakan nilai ElementName hampir selalu menyertakan Jalur sederhana yang menamai properti yang ada pada objek yang dirujuk. Adalah umum bahwa properti sumber dari elemen bernama dan properti tujuan pada target memiliki nama yang sama dan menggunakan jenis nilai yang sama, ini adalah skenario yang Anda lihat cukup sering dalam definisi templat kontrol yang menggabungkan bagian kontrol tetapi properti permukaan dari bagian. Jika properti sumber dan tujuan menggunakan jenis yang berbeda, tentukan nilai Konverter yang dapat mengatasi perbedaan jenis dan mengembalikan nilai yang sesuai untuk tujuan.
Untuk informasi selengkapnya tentang namescope XAML dan pengaruhnya terhadap pengikatan dan akses terprogram lainnya ke objek yang dibuat dari XAML, lihat namescope XAML.
Nilai ElementName secara teknis dapat berupa string apa pun, tetapi nilai atribut Nama dan x:Name diberlakukan agar valid dalam tata bahasa XamlName, sehingga Anda biasanya terikat oleh tata bahasa tersebut untuk nilai ElementName juga. Untuk informasi selengkapnya tentang apa yang valid untuk nama elemen, lihat bagian "Tata bahasa XamlName" di referensi atribut x:Name .
Anda tidak dapat mengatur nilai properti objek Pengikatan setelah pengikatan tersebut dilampirkan ke elemen target dan properti target. Jika Anda mencoba ini, Anda akan mendapatkan pengecualian run-time.