Bagikan melalui


FrameworkElement.SetBinding(DependencyProperty, BindingBase) Metode

Definisi

Melampirkan pengikatan ke FrameworkElement, menggunakan objek pengikatan yang disediakan.

void SetBinding(DependencyProperty const& dp, BindingBase const& binding);
public void SetBinding(DependencyProperty dp, BindingBase binding);
function setBinding(dp, binding)
Public Sub SetBinding (dp As DependencyProperty, binding As BindingBase)

Parameter

dp
DependencyProperty

Pengidentifikasi properti dependensi properti yang terikat data.

binding
BindingBase

Pengikatan yang digunakan untuk properti .

Contoh

Contoh ini menetapkan pengikatan ke properti dependensi pada objek dengan memanggil SetBinding.

// Create the source string.
string s = "Hello";

// Create the binding description.
Binding b = new Binding();
b.Mode = BindingMode.OneTime;
b.Source = s;

// Attach the binding to the target.
TextBlock MyText = new TextBlock();
MyText.SetBinding(TextBlock.TextProperty, b);

Keterangan

Metode ini adalah metode kenyamanan yang memanggil BindingOperations.SetBinding, meneruskan instans saat ini sebagai target parameter .

Jenis binding parameter adalah BindingBase karena alasan kompatibilitas, tetapi di Windows Runtime Anda selalu melewati instans Pengikatan . Binding berasal dari BindingBase.

Parameter dp mengambil pengidentifikasi properti dependensi. Untuk informasi selengkapnya tentang properti dependensi dan bagaimana nilai DependencyProperty berfungsi sebagai pengidentifikasi, lihat Gambaran umum properti dependensi.

Anda dapat mengikat properti dependensi kustom atau properti terlampir kustom, pengidentifikasi yang Anda lewati sebagai dp parameter tidak harus menjadi properti yang ditentukan Windows Runtime.

Apakah pengikatan yang dibuat dari kode akan dapat menggunakan konteks data bertindak tergantung pada pertimbangan masa pakai objek. Misalnya, nilai DataContext yang diatur dari XAML tidak akan tersedia hingga XAML diurai. Dalam hal ini Anda mungkin ingin menggunakan handler Yang dimuat untuk menambahkan pengikatan dari kode.

Catatan

Memanggil SetBinding metode 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 (misalnya 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.

Berlaku untuk

Lihat juga