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. Default adalah null.

Atribut

BindableAttribute

Keterangan

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

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

ItemsSource Saat properti diatur, Items koleksi dibuat baca-saja dan berukuran 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 menjadi null tidak berpengaruh.

Catatan

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

Bidang pengidentifikasi	ItemsSourceProperty
Properti metadata diatur ke true	Tidak ada