ItemsControl.ItemsSource Properti

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur koleksi yang digunakan untuk menghasilkan konten ItemsControl.

public:
 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };

[System.ComponentModel.Bindable(true)]
public System.Collections.IEnumerable ItemsSource { get; set; }

[<System.ComponentModel.Bindable(true)>]
member this.ItemsSource : System.Collections.IEnumerable with get, set

Public Property ItemsSource As IEnumerable

Nilai Properti

IEnumerable

Koleksi yang digunakan untuk menghasilkan konten ItemsControl. Defaultnya adalah null.

Atribut

BindableAttribute

Keterangan

Model Konten: Properti ini dapat digunakan untuk menambahkan item ke ItemsControl.

Skenario umumnya adalah menggunakan ItemsControl seperti ListBox, , ListViewatau TreeView untuk menampilkan pengumpulan data, atau untuk mengikat ItemsControl ke objek koleksi. Untuk mengikat ItemsControl ke objek koleksi, gunakan ItemsSource properti . Perhatikan bahwa ItemsSource properti mendukung OneWay pengikatan secara default.

ItemsSource Ketika properti diatur, Items koleksi dibuat baca-saja dan ukuran tetap.

Ketika ItemsSource sedang digunakan, atur properti untuk null menghapus koleksi dan memulihkan penggunaan ke Items, yang akan kosong ItemCollection. Ketika ItemsSource tidak digunakan, nilai properti ini adalah null, dan mengaturnya agar null tidak berpengaruh.

Nota

Dalam kebanyakan kasus, Anda tidak perlu menerapkan koleksi Anda sendiri. Sebagai gantinya, pertimbangkan untuk menggunakan ObservableCollection<T> atau koleksi lain yang sudah ada. Untuk informasi selengkapnya, lihat "Objek Koleksi yang Digunakan sebagai Sumber Pengikatan" di Gambaran Umum Sumber Pengikatan.

Penggunaan Atribut XAML

<object ItemsSource="bindingDeclaration"/>

Nilai XAML

bindingDeclaration Sebuah Binding deklarasi. Lihat Mengikat Ekstensi Markup untuk informasi selengkapnya.

Informasi Properti Dependensi

Item	Nilai
Bidang pengidentifikasi	ItemsSourceProperty
Properti metadata diatur ke true	Tidak