Binding Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Data

Rakitan:: PresentationFramework.dll

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.

Menyediakan akses tingkat tinggi ke definisi pengikatan, yang menghubungkan properti pengikatan objek target (biasanya, elemen WPF), dan sumber data apa pun (misalnya, database, file XML, atau objek apa pun yang berisi data).

public ref class Binding : System::Windows::Data::BindingBase

public class Binding : System.Windows.Data.BindingBase

type Binding = class
    inherit BindingBase

Public Class Binding
Inherits BindingBase

Warisan: Object

MarkupExtension

BindingBase
Binding

Keterangan

Pengikatan data Windows Presentation Foundation (WPF) menyediakan cara yang sederhana dan konsisten bagi aplikasi untuk menyajikan dan berinteraksi dengan data. Pengikatan data memungkinkan Anda menyinkronkan nilai properti dari dua objek yang berbeda.

Untuk membuat pengikatan, gunakan Binding kelas atau salah satu kelas lain yang mewarisi BindingBase. Terlepas dari objek apa yang Anda ikat dan sifat sumber data Anda, setiap pengikatan mengikuti model yang diilustrasikan oleh gambar berikut.

Diagram pengikatan data dasar Diagram

Gambar menunjukkan konsep pengikatan data WPF mendasar berikut.

Setiap pengikatan biasanya memiliki empat komponen ini: objek target pengikatan, properti target, sumber pengikatan, dan Path ke nilai dalam sumber pengikatan yang akan digunakan. Misalnya, jika Anda ingin mengikat konten TextBox ke properti Nama objek Karyawan, objek target Anda adalah TextBox, properti target adalah Text properti , nilai yang akan digunakan adalah Nama, dan objek sumber adalah objek Karyawan.
Properti target harus merupakan properti dependensi. Ini juga berarti Bahwa Anda tidak dapat mengikat bidang. Sebagian besar properti UIElement objek adalah properti dependensi dan sebagian besar properti dependensi, kecuali yang baca-saja, mendukung pengikatan data secara default. (Hanya DependencyObject jenis yang dapat menentukan properti dependensi dan semua UIElement objek yang berasal dari DependencyObject.)
Meskipun tidak ditentukan dalam gambar, perlu dicatat bahwa objek sumber pengikatan tidak dibatasi untuk menjadi objek CLR kustom. Pengikatan data WPF mendukung data dalam bentuk objek CLR dan XML. Untuk memberikan beberapa contoh, sumber pengikatan Anda mungkin merupakan UIElement, objek daftar apa pun, objek CLR yang terkait dengan data ADO.NET atau Layanan Web, atau XmlNode yang berisi data XML Anda.

Mode Gunakan properti untuk menentukan arah aliran data. Untuk mendeteksi perubahan sumber dalam pengikatan satu arah atau dua arah, sumber harus menerapkan mekanisme pemberitahuan perubahan properti yang sesuai seperti INotifyPropertyChanged. Misalnya, lihat Cara: Menerapkan Pemberitahuan Perubahan Properti. Properti UpdateSourceTrigger menentukan waktu pembaruan sumber. Untuk informasi selengkapnya, lihat "Konsep Pengikatan Data Dasar" di Gambaran Umum Pengikatan Data.

Penggunaan Atribut XAML

<object property="{Binding  declaration}"/>

Nilai XAML

declaration
Nol atau beberapa klausul penetapan atribut yang dipisahkan oleh koma (,). Untuk informasi selengkapnya, lihat Ikhtisar Ekstensi Markup Pengikatan atau Deklarasi Pengikatan.

Konstruktor

Binding()	Menginisialisasi instans baru kelas Binding.
Binding(String)	Menginisialisasi instans Binding baru kelas dengan jalur awal.

Bidang

DoNothing	Digunakan sebagai nilai yang dikembalikan untuk menginstruksikan mesin pengikatan untuk tidak melakukan tindakan apa pun.
IndexerName	Digunakan sebagai PropertyName dari PropertyChangedEventArgs untuk menunjukkan bahwa properti pengindeks telah berubah.
SourceUpdatedEvent	Mengidentifikasi peristiwa terlampir SourceUpdated .
TargetUpdatedEvent	Mengidentifikasi peristiwa terlampir TargetUpdated .
XmlNamespaceManagerProperty	XmlNamespaceManager Mengidentifikasi properti terlampir.

Properti

AsyncState	Mendapatkan atau mengatur data buram yang diteruskan ke dispatcher data asinkron.
BindingGroupName	Mendapatkan atau mengatur nama tempat BindingGroup pengikatan ini berada. (Diperoleh dari BindingBase)
BindsDirectlyToSource	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengevaluasi Path relatif terhadap item data atau DataSourceProvider objek.
Converter	Mendapatkan atau mengatur pengonversi yang akan digunakan.
ConverterCulture	Mendapatkan atau mengatur budaya untuk mengevaluasi konverter.
ConverterParameter	Mendapatkan atau mengatur parameter untuk diteruskan ke Converter.
Delay	Mendapatkan atau mengatur jumlah waktu, dalam milidetik, untuk menunggu sebelum memperbarui sumber pengikatan setelah nilai pada target berubah. (Diperoleh dari BindingBase)
ElementName	Mendapatkan atau mengatur nama elemen yang akan digunakan sebagai objek sumber pengikatan.
FallbackValue	Mendapatkan atau mengatur nilai yang akan digunakan saat pengikatan tidak dapat mengembalikan nilai. (Diperoleh dari BindingBase)
IsAsync	Mendapatkan atau menetapkan nilai yang menunjukkan apakah Binding nilai harus mendapatkan dan mengatur nilai secara asinkron.
Mode	Mendapatkan atau menetapkan nilai yang menunjukkan arah aliran data dalam pengikatan.
NotifyOnSourceUpdated	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menaikkan SourceUpdated peristiwa saat nilai ditransfer dari target pengikatan ke sumber pengikatan.
NotifyOnTargetUpdated	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menaikkan TargetUpdated peristiwa saat nilai ditransfer dari sumber pengikatan ke target pengikatan.
NotifyOnValidationError	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menaikkan Error peristiwa terlampir pada objek terikat.
Path	Mendapatkan atau mengatur jalur ke properti sumber pengikatan.
RelativeSource	Mendapatkan atau mengatur sumber pengikatan dengan menentukan lokasinya relatif terhadap posisi target pengikatan.
Source	Mendapatkan atau mengatur objek yang akan digunakan sebagai sumber pengikatan.
StringFormat	Mendapatkan atau mengatur string yang menentukan cara memformat pengikatan jika menampilkan nilai terikat sebagai string. (Diperoleh dari BindingBase)
TargetNullValue	Mendapatkan atau menetapkan nilai yang digunakan dalam target saat nilai sumber adalah `null`. (Diperoleh dari BindingBase)
UpdateSourceExceptionFilter	Mendapatkan atau mengatur handler yang dapat Anda gunakan untuk menyediakan logika kustom untuk menangani pengecualian yang ditemui mesin pengikatan selama pembaruan nilai sumber pengikatan. Ini hanya berlaku jika Anda telah mengaitkan ExceptionValidationRule dengan pengikatan Anda.
UpdateSourceTrigger	Mendapatkan atau menetapkan nilai yang menentukan waktu pembaruan sumber pengikatan.
ValidatesOnDataErrors	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menyertakan DataErrorValidationRule.
ValidatesOnExceptions	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menyertakan ExceptionValidationRule.
ValidatesOnNotifyDataErrors	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menyertakan NotifyDataErrorValidationRule.
ValidationRules	Mendapatkan kumpulan aturan yang memeriksa validitas input pengguna.
XPath	Mendapatkan atau mengatur `XPath` kueri yang mengembalikan nilai pada sumber pengikatan XML untuk digunakan.

Properti yang Terlampir

XmlNamespaceManager

Mendapatkan atau mengatur yang XmlNamespaceManager digunakan untuk melakukan kueri sadar XPath namespace dalam pengikatan XML.

Metode

AddSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Menambahkan handler untuk kejadian terlampir SourceUpdated .
AddTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Menambahkan handler untuk kejadian terlampir TargetUpdated .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetXmlNamespaceManager(DependencyObject)	Mengembalikan objek manajer namespace XML yang digunakan oleh pengikatan yang dilampirkan ke objek yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ProvideValue(IServiceProvider)	Mengembalikan objek yang harus diatur pada properti tempat pengikatan dan ekstensi ini diterapkan. (Diperoleh dari BindingBase)
RemoveSourceUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Menghapus handler untuk kejadian terlampir SourceUpdated .
RemoveTargetUpdatedHandler(DependencyObject, EventHandler<DataTransferEventArgs>)	Menghapus handler untuk kejadian terlampir TargetUpdated .
SetXmlNamespaceManager(DependencyObject, XmlNamespaceManager)	Mengatur objek pengelola namespace yang digunakan oleh pengikatan yang dilampirkan ke elemen yang disediakan.
ShouldSerializeFallbackValue()	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai FallbackValue efektif properti pada instans kelas ini. (Diperoleh dari BindingBase)
ShouldSerializePath()	Menunjukkan apakah Path properti harus dipertahankan.
ShouldSerializeSource()	Menunjukkan apakah Source properti harus dipertahankan.
ShouldSerializeTargetNullValue()	Mengembalikan nilai yang menunjukkan apakah TargetNullValue properti harus diserialisasikan. (Diperoleh dari BindingBase)
ShouldSerializeValidationRules()	Menunjukkan apakah ValidationRules properti harus dipertahankan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara yang Terlampir

SourceUpdated	Terjadi ketika nilai ditransfer dari target pengikatan ke sumber pengikatan, tetapi hanya untuk pengikatan dengan nilai yang NotifyOnSourceUpdated diatur ke `true`.
TargetUpdated	Terjadi ketika nilai ditransfer dari sumber pengikatan ke target pengikatan, tetapi hanya untuk pengikatan dengan nilai yang NotifyOnTargetUpdated diatur ke `true`.

Berlaku untuk

Share via