Ekstensi markup {Binding}

Catatan

Mekanisme pengikatan baru tersedia untuk Windows 10, yang dioptimalkan untuk performa dan produktivitas pengembang. Lihat ekstensi markup {x:Bind}.

Catatan

Untuk informasi umum tentang menggunakan pengikatan data di aplikasi Anda dengan {Binding} (dan untuk perbandingan all-up antara {x:Bind} dan {Binding}), lihat Pengikatan data secara mendalam.

Ekstensi markup {Binding} digunakan untuk mengikat properti data pada kontrol ke nilai yang berasal dari sumber data seperti kode. Ekstensi markup {Binding} dikonversi pada waktu muat XAML menjadi instans kelas Pengikatan . Objek pengikatan ini mendapatkan nilai dari properti pada sumber data, dan mendorongnya ke properti pada kontrol. Objek pengikatan dapat dikonfigurasi secara opsional untuk mengamati perubahan nilai properti sumber data dan memperbarui dirinya sendiri berdasarkan perubahan tersebut. Ini juga dapat dikonfigurasi secara opsional untuk mendorong perubahan ke nilai kontrol kembali ke properti sumber. Properti yang merupakan target pengikatan data harus merupakan properti dependensi. Untuk informasi selengkapnya, lihat Gambaran umum properti dependensi.

{Binding} memiliki prioritas properti dependensi yang sama dengan nilai lokal, dan mengatur nilai lokal dalam kode imperatif akan menghapus efek {Binding} yang diatur dalam markup.

Penggunaan atribut XAML

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Istilah	Deskripsi
propertyPath	String yang menentukan jalur properti untuk pengikatan. Info selengkapnya ada di bagian Jalur properti di bawah ini.
bindingProperties	propName=value[, propName=value]* Satu atau beberapa properti pengikatan yang ditentukan menggunakan sintaks pasangan nama/nilai.
propName	Nama string properti yang akan diatur pada objek Pengikatan . Misalnya, "Konverter".
nilai	Nilai untuk mengatur properti ke. Sintaks argumen bergantung pada properti Properti kelas Pengikatan yang dapat diatur dengan bagian {Binding} di bawah ini.

Jalur properti

Jalur menjelaskan properti yang Anda ikat (properti sumber). Jalur adalah parameter posisional, yang berarti Anda dapat menggunakan nama parameter secara eksplisit ({Binding Path=EmployeeID}), atau Anda dapat menentukannya sebagai parameter pertama yang tidak disebutkan namanya ({Binding EmployeeID}).

Jenis Jalur adalah jalur properti, yang merupakan string yang mengevaluasi ke properti atau sub-properti dari jenis kustom atau jenis kerangka kerja Anda. Jenisnya bisa, tetapi tidak perlu, DependencyObject. Langkah-langkah dalam jalur properti dibatasi oleh titik-titik (.), dan Anda dapat menyertakan beberapa pemisah untuk melintasi sub-properti berturut-turut. Gunakan pemisah titik terlepas dari bahasa pemrograman yang digunakan untuk mengimplementasikan objek yang terikat.

Misalnya, untuk mengikat UI ke properti nama depan objek karyawan, jalur properti Anda mungkin "Employee.FirstName". Jika Anda mengikat kontrol item ke properti yang berisi dependen karyawan, jalur properti Anda mungkin "Employee.Dependents", dan templat item kontrol item akan mengurus menampilkan item di "Dependen".

Jika sumber data adalah koleksi, jalur properti dapat menentukan item dalam koleksi berdasarkan posisi atau indeksnya. Misalnya, "Teams[0]. Pemutar", di mana harfiah "[]" menyertakan "0" yang menentukan item pertama dalam koleksi.

Saat menggunakan pengikatan ElementName ke DependencyObject yang ada, Anda dapat menggunakan properti terlampir sebagai bagian dari jalur properti. Untuk membedakan properti terlampir sehingga titik perantara dalam nama properti terlampir tidak dianggap sebagai langkah ke jalur properti, letakkan tanda kurung di sekitar nama properti terlampir yang memenuhi syarat pemilik; misalnya, (AutomationProperties.Name).

Objek perantara jalur properti disimpan sebagai objek PropertyPath dalam representasi run-time, tetapi sebagian besar skenario tidak perlu berinteraksi dengan objek PropertyPath dalam kode. Anda biasanya dapat menentukan info pengikatan yang Anda butuhkan menggunakan XAML.

Untuk informasi selengkapnya tentang sintaks string untuk jalur properti, jalur properti di area fitur animasi, dan membuat objek PropertyPath , lihat Sintaks jalur properti.

Properti kelas Pengikatan yang dapat diatur dengan {Binding}

{Binding} diilustrasikan dengan sintaks tempat penampung bindingProperties karena ada beberapa properti baca/tulis pengikatan yang dapat diatur dalam ekstensi markup. Properti dapat diatur dalam urutan apa pun dengan pasangannilaipropName yang= dipisahkan koma. Beberapa properti memerlukan tipe yang tidak memiliki konversi jenis, sehingga ini memerlukan ekstensi markup dari properti mereka sendiri yang ditumpuk dalam {Binding}.

Properti	Deskripsi
Jalur	Lihat bagian Jalur properti di atas.
Converter	Menentukan objek konverter yang dipanggil oleh mesin pengikatan. Konverter dapat diatur dalam markup menggunakan ekstensi markup {StaticResource} untuk mereferensikan ke objek tersebut dari kamus sumber daya.
ConverterLanguage	Menentukan budaya yang akan digunakan oleh konverter. (Jika Anda mengatur Konverter.) Budaya ditetapkan sebagai pengidentifikasi berbasis standar. Untuk informasi selengkapnya, lihat ConverterLanguage
ConverterParameter	Menentukan parameter konverter yang dapat digunakan dalam logika konverter. (Jika Anda mengatur Konverter.) Sebagian besar konverter menggunakan logika sederhana yang mendapatkan semua info yang mereka butuhkan dari nilai yang diteruskan untuk dikonversi, dan tidak memerlukan nilai ConverterParameter . Parameter ConverterParameter adalah untuk implementasi konverter yang lebih kompleks yang memiliki logika kondisional yang mematikan apa yang diteruskan di ConverterParameter. Anda dapat menulis pengonversi yang menggunakan nilai selain string tetapi ini jarang terjadi, lihat Keterangan di ConverterParameter untuk informasi selengkapnya.
ElementName	Menentukan sumber data dengan mereferensikan elemen lain dalam konstruksi XAML yang sama yang memiliki properti Nama atau atribut x:Name. Ini sering digunakan untuk berbagi nilai terkait atau menggunakan sub-properti dari satu elemen UI untuk memberikan nilai tertentu untuk elemen lain, misalnya dalam templat kontrol XAML.
FallbackValue	Menentukan nilai yang akan ditampilkan ketika sumber atau jalur tidak dapat diselesaikan.
Mode	Menentukan mode pengikatan, sebagai salah satu nilai ini: "OneTime", "OneWay", atau "TwoWay". Ini sesuai dengan nama konstanta enumerasi BindingMode . Defaultnya adalah "OneWay". Perhatikan bahwa ini berbeda dari default untuk {x:Bind}, yaitu "OneTime".
RelativeSource	Menentukan sumber data dengan menjelaskan posisi sumber pengikatan relatif terhadap posisi target pengikatan. Ini paling sering digunakan dalam pengikatan dalam templat kontrol XAML. Mengatur ekstensi markup {RelativeSource}.
Sumber	Menentukan sumber data objek. Dalam ekstensi markup Pengikatan , properti Sumber memerlukan referensi objek, seperti referensi ekstensi markup {StaticResource} . Jika properti ini tidak ditentukan, konteks data bertindak menentukan sumbernya. Lebih umum untuk tidak menentukan nilai Sumber dalam pengikatan individual, dan sebaliknya mengandalkan DataContext bersama untuk beberapa pengikatan. Untuk informasi selengkapnya, lihat DataContext atau Pengikatan data secara mendalam.
TargetNullValue	Menentukan nilai yang akan ditampilkan saat nilai sumber diselesaikan tetapi secara eksplisit null.
UpdateSourceTrigger	Menentukan waktu pembaruan sumber pengikatan. Jika tidak ditentukan, defaultnya adalah Default.

Catatan Jika Anda mengonversi markup dari {x:Bind} ke {Binding}, maka ketahui perbedaan nilai default untuk properti Mode .

Converter, ConverterLanguage , dan ConverterLanguage semuanya terkait dengan skenario mengonversi nilai atau jenis dari sumber pengikatan menjadi jenis atau nilai yang kompatibel dengan properti target pengikatan. Untuk informasi dan contoh selengkapnya, lihat bagian "Konversi data" dari Pengikatan data secara mendalam.

Catatan

Mulai dari Windows 10, versi 1607, kerangka kerja XAML menyediakan konverter Boolean ke Visibilitas bawaan. Pengonversi memetakan true ke nilai Enumerasi terlihat dan false ke Diciutkan sehingga Anda dapat mengikat properti Visibilitas ke Boolean tanpa membuat pengonversi. Untuk menggunakan konverter bawaan, versi SDK target minimum aplikasi Anda harus 14393 atau yang lebih baru. Anda tidak dapat menggunakannya saat aplikasi menargetkan versi Windows 10 sebelumnya. Untuk informasi selengkapnya tentang versi target, lihat Kode adaptif versi.

Source, RelativeSource, dan ElementName menentukan sumber pengikatan, sehingga keduanya saling eksklusif.

Tips Jika Anda perlu menentukan kurung kurawal tunggal untuk nilai, seperti di Jalur atau ConverterParameter, maka awali dengan garis miring terbalik: \{. Atau, sertakan seluruh string yang berisi kurung kurawal yang perlu dilepaskan dalam kumpulan kutipan sekunder, misalnya ConverterParameter='{Mix}'.

Contoh

<!-- binding a UI element to a view model -->    
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

Contoh kedua menetapkan empat properti Pengikatan yang berbeda: ElementName, Path, Mode , dan Converter. Jalur dalam hal ini ditampilkan secara eksplisit bernama sebagai properti Pengikatan . Jalur dievaluasi ke sumber pengikatan data yang merupakan objek lain di pohon objek run-time yang sama, Slider bernama sliderValueConverter.

Perhatikan bagaimana nilai properti Konverter menggunakan ekstensi markup lain, ekstensi markup {StaticResource}, sehingga ada dua penggunaan ekstensi markup berlapis di sini. Bagian dalam dievaluasi terlebih dahulu, sehingga setelah sumber daya diperoleh, ada IValueConverter praktis (kelas kustom yang dibuat oleh local:S2Formatter elemen dalam sumber daya) yang dapat digunakan pengikatan.

Dukungan alat

Microsoft IntelliSense di Microsoft Visual Studio menampilkan properti konteks data saat menulis {Binding} di editor markup XAML. Segera setelah Anda mengetik "{Binding", properti konteks data yang sesuai untuk Jalur ditampilkan di menu dropdown. IntelliSense juga membantu dengan properti Pengikatan lainnya. Agar ini berfungsi, Anda harus memiliki konteks data atau kumpulan konteks data waktu desain di halaman markup. Buka Definisi (F12) juga berfungsi dengan {Binding}. Atau, Anda dapat menggunakan dialog pengikatan data.