FrameworkElement.SetBinding(DependencyProperty, BindingBase) Metode

Definisi

Ruang nama:

Windows.UI.Xaml

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);

'Create the source string 
Dim s As String = "Hello"

'Create the binding description 
Dim b As New Binding()
b.Mode = BindingMode.OneTime
b.Source = s

'Attach the binding to the target 
Dim MyText As New TextBlock()
MyText.SetBinding(TextBlock.TextProperty, b)

Keterangan

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

Jenis parameter pengikatan adalah BindingBase karena alasan kompatibilitas, tetapi di Windows Runtime Anda selalu meneruskan instans Pengikatan . Pengikatan 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 parameter dp 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 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
• BindingOperations
• Pengikatan data secara mendalam
• Gambaran umum properti dependensi