BindingOperations.SetBinding Metode

Definisi

Ruang nama:

Windows.UI.Xaml.Data

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.

dp

DependencyProperty

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.

Lihat juga

• Binding
• Sampel pengikatan data XAML
• Pengikatan data secara mendalam