FrameworkContentElement.DataContext Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur konteks data untuk elemen saat berpartisipasi dalam pengikatan data.

public:
 property System::Object ^ DataContext { System::Object ^ get(); void set(System::Object ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public object DataContext { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.DataContext : obj with get, set

Public Property DataContext As Object

Nilai Properti

Object

Objek yang digunakan sebagai konteks data.

Atribut

LocalizabilityAttribute

Contoh

Contoh berikut mengatur pengikatan pada Paragraph elemen, dengan membuat objek data kustom baru, menetapkan objek tersebut sebagai DataContext, dan mengatur jalur pengikatan ke properti di dalamnya.

MyData myDataObject = new MyData();
myflowdocument.DataContext = myDataObject;
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData");

Dim myDataObject As New MyData()
myflowdocument.DataContext = myDataObject
introParagraph.SetBinding(Paragraph.TagProperty, "CustomData")

Keterangan

Konteks data adalah konsep yang memungkinkan elemen untuk mewarisi informasi dari elemen induknya tentang sumber pengikatan yang digunakan untuk pengikatan, serta karakteristik lain dari pengikatan seperti jalur.

Konteks data dapat diatur langsung ke objek runtime bahasa umum (CLR), dengan pengikatan yang mengevaluasi ke properti objek tersebut. Atau, Anda dapat mengatur konteks data ke DataSourceProvider objek.

Properti dependensi ini mewarisi nilai properti. Jika ada elemen turunan tanpa nilai lain untuk DataContext ditetapkan melalui nilai atau gaya lokal, sistem properti akan mengatur nilai menjadi DataContext nilai elemen induk terdekat dengan nilai ini ditetapkan.

Atau, Anda dapat menggunakan salah satu properti Binding kelas berikut untuk menentukan sumber pengikatan secara eksplisit: ElementName, , Sourceatau RelativeSource. Untuk informasi selengkapnya, lihat Cara: Menentukan Sumber Pengikatan.

Di XAML, DataContext paling umum diatur ke sebagai Binding deklarasi. Anda dapat menggunakan sintaks elemen properti atau sintaks atribut. Sintaks atribut ditampilkan dalam contoh di halaman ini. Anda juga dapat mengatur DataContext dalam kode.

Penggunaan Elemen Properti XAML

<object>
  <object.DataContext>
    <dataContextObject />
  </object.DataContext>
</object>

Penggunaan Atribut XAML

<object DataContext="bindingUsage"/>

-atau-

<object DataContext="{resourceExtension contextResourceKey}"/>

Nilai XAML

dataContextObject Objek yang disematkan langsung yang berfungsi sebagai konteks data untuk pengikatan apa pun dalam elemen induk. Biasanya, objek ini adalah Binding subkelas atau lainnya BindingBase . Atau, data mentah dari jenis objek CLR apa pun yang dimaksudkan untuk pengikatan dapat ditempatkan di sini, dengan pengikatan aktual yang ditentukan nanti.

bindingUsage Penggunaan pengikatan yang mengevaluasi ke konteks data yang sesuai. Untuk detailnya, lihat Ekstensi Markup Pengikatan .

resourceExtension Salah satu hal berikut: StaticResource, atau DynamicResource. Penggunaan ini digunakan saat merujuk pada data mentah yang didefinisikan sebagai objek dalam sumber daya. Lihat Sumber Daya XAML.

contextResourceKey Pengidentifikasi kunci untuk objek yang diminta dari dalam ResourceDictionary.

Informasi Properti Dependensi

Barang	Nilai
Bidang pengidentifikasi	DataContextProperty
Properti metadata diatur ke true	Inherits