Bagikan melalui


Binding Kelas

Definisi

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

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 tersebut 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 ke TextBox 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 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 klausa 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

Mengidentifikasi properti terlampir XmlNamespaceManager .

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 menetapkan 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 yang 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 dari instans Type saat ini.

(Diperoleh dari Object)
GetXmlNamespaceManager(DependencyObject)

Mengembalikan objek pengelola namespace XML yang digunakan oleh pengikatan yang dilampirkan ke objek yang ditentukan.

MemberwiseClone()

Membuat salinan dangkal dari 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 layanan 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

Lihat juga