BindingOperations.SetBinding Metode
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.
Mengaitkan Pengikatan dengan properti target pada objek target. Metode ini setara dengan menggunakan ekstensi markup {Binding} dalam markup XAML.
static void SetBinding(DependencyObject const& target, DependencyProperty const& dp, BindingBase const& binding);
public static void SetBinding(DependencyObject target, DependencyProperty dp, BindingBase binding);
function setBinding(target, dp, binding)
Public Shared Sub SetBinding (target As DependencyObject, dp As DependencyProperty, binding As BindingBase)
Parameter
- target
- DependencyObject
Objek yang harus menjadi target pengikatan yang dievaluasi.
Properti pada target untuk mengikat, ditentukan oleh pengidentifikasinya. Pengidentifikasi ini biasanya tersedia sebagai properti baca-saja statis pada jenis yang menentukan objek target , atau salah satu jenis dasarnya. Anda juga dapat mengikat ke properti terlampir, tetapi lihat Keterangan.
- binding
- BindingBase
Pengikatan untuk ditetapkan ke properti target. Pengikatan ini harus diinisialisasi: properti Pengikatan penting seperti Jalur harus sudah diatur sebelum meneruskannya sebagai parameter.
Keterangan
Anda dapat mengikat properti dependensi kustom atau properti terlampir kustom, pengidentifikasi yang Anda lewati sebagai parameter dp tidak harus menjadi properti yang ditentukan Windows Runtime.
BindingOperations.SetBinding adalah metode utilitas statis, dan pada dasarnya melakukan hal yang sama seperti FrameworkElement.SetBinding. Lebih umum menggunakan FrameworkElement.SetBinding karena ini adalah metode instans. Salah satu perbedaan pentingnya adalah bahwa BindingOperations.SetBinding dapat menggunakan nilai targetdari DependencyObject apa pun, sedangkan FrameworkElement.SetBinding hanya dapat digunakan untuk target FrameworkElement . Ini biasanya tidak masalah untuk sebagian besar kelas Windows Runtime yang digunakan untuk UI XAML, karena sebagian besar ini adalah subkelas FrameworkElement . Tetapi perbedaannya mungkin penting jika Anda menargetkan pengikatan pada kelas kustom Anda sendiri yang berasal dari DependencyObject atau UIElement.
Catatan
Memanggil metode SetBinding dan meneruskan objek Pengikatan baru tidak akan selalu menghapus pengikatan yang ada. Sebagai gantinya, Anda harus terlebih dahulu memanggil metode DependencyObject.ClearValue , lalu memanggil SetBinding.
Pengikatan ke properti terlampir
Anda dapat menempatkan pengikatan data pada properti terlampir apa pun yang didukung objek target. Secara teknis DependencyObject mendukung semua kemungkinan properti terlampir, tetapi Anda biasanya hanya mengatur pengikatan pada properti terlampir yang relevan dengan objek tersebut atau skenario Anda. Misalnya Anda akan mengatur pengikatan pada Grid.Row hanya jika Anda mengantisipasi bahwa elemen target memiliki induk Kisi yang akan menggunakan info tersebut. Tentukan parameter dp sebagai pengidentifikasi properti dependensi yang ada pada kelas pemilik properti terlampir (untuk contoh Grid.Row , pengidentifikasi tersebut adalah Grid.RowProperty). Anda tidak akan menemukan pengidentifikasi tersebut pada target karena ini adalah properti terlampir. Untuk informasi selengkapnya tentang properti terlampir, lihat Gambaran umum properti terlampir.