ItemCollection Kelas

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Menyimpan daftar item yang merupakan konten dari ItemsControl.

public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public sealed class ItemCollection : System.Windows.Data.CollectionView, System.Collections.IList, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties, System.Windows.IWeakEventListener

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface ICollection
    interface IEnumerable
    interface IList
    interface ICollectionViewLiveShaping
    interface IEditableCollectionView
    interface IEditableCollectionViewAddNewItem
    interface IItemProperties
    interface IWeakEventListener

Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener

Warisan

Object

DispatcherObject

CollectionView

ItemCollection

Atribut

LocalizabilityAttribute

Penerapan

ICollection IEnumerable IList IEditableCollectionView IItemProperties IWeakEventListener IEditableCollectionViewAddNewItem ICollectionViewLiveShaping

Contoh

Jika Anda memiliki ItemsControl, seperti ListBox yang memiliki konten, Anda dapat menggunakan Items properti untuk mengakses ItemCollection, yang merupakan tampilan. Karena ini adalah tampilan, Anda kemudian dapat menggunakan fungsionalitas terkait tampilan seperti pengurutan, pemfilteran, dan pengelompokan. Perhatikan bahwa saat ItemsSource diatur, operasi tampilan mendelegasikan ke tampilan di atas koleksi ItemsSource. Oleh karena itu, ItemCollection mendukung pengurutan, pemfilteran, dan pengelompokan hanya jika tampilan yang didelegasikan mendukungnya.

Contoh berikut menunjukkan cara mengurutkan konten bernama ListBoxmyListBox. Dalam contoh ini, Content adalah nama properti yang akan diurutkan.

myListBox.Items.SortDescriptions.Add(
    new SortDescription("Content", ListSortDirection.Descending));

myListBox.Items.SortDescriptions.Add(New SortDescription("Content", ListSortDirection.Descending))

Saat Anda melakukan ini, tampilan mungkin atau mungkin bukan tampilan default, tergantung pada bagaimana data disiapkan di Anda ItemsControl. Misalnya, ketika ItemsSource properti terikat ke CollectionViewSource, tampilan yang Anda peroleh menggunakan Items properti bukan tampilan default.

Jika Anda ItemsControl terikat (Anda menggunakan ItemsSource properti ), maka Anda bisa melakukan hal berikut untuk mendapatkan tampilan default:

CollectionView myView;

Private myView As CollectionView

myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);

myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)

Secara bergantian, Anda dapat menentukan kriteria pemfilteran, pengurutan, dan pengelompokan di XAML menggunakan CollectionViewSource.

Keterangan

ItemCollection mempertahankan kumpulan item seperti string, objek, simpul XML, elemen, dan koleksi lainnya. ItemsControl menggunakan data dalam ItemCollection untuk menghasilkan kontennya. Jika Anda ingin menggabungkan lebih dari satu koleksi, tetapkan CompositeCollection ke ItemsSource properti Anda ItemsControl.

Items Gunakan properti atau ItemsSource properti untuk menentukan koleksi yang harus digunakan untuk menghasilkan konten AndaItemsControl. ItemsSource Ketika properti diatur, Items koleksi akan dibuat baca-saja dan berukuran tetap. Ini berarti bahwa jika Anda menggunakan ItemsSource properti , Anda tidak dapat menambahkan, menghapus, atau mengubah item secara ItemCollection langsung.

ItemCollectionCollectionView adalah dan oleh karena itu menyediakan fungsionalitas tampilan koleksi, seperti pengurutan, pengelompokan, dan pemfilteran. Untuk informasi selengkapnya, lihat SortDescriptions, Filter, and GroupDescriptions.

Untuk informasi selengkapnya tentang tampilan pengumpulan, lihat Gambaran Umum Pengikatan Data.

Properti

AllowsCrossThreadChanges	Mendapatkan nilai yang menunjukkan apakah utas selain yang membuat CollectionView dapat mengubah SourceCollection. (Diperoleh dari CollectionView)
CanChangeLiveFiltering	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi mendukung mengaktifkan atau menonaktifkan pemfilteran data secara real time.
CanChangeLiveGrouping	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi mendukung mengaktifkan atau menonaktifkan pengelompokan data secara real time.
CanChangeLiveSorting	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi mendukung mengaktifkan atau menonaktifkan pengurutan data secara real time.
CanFilter	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi ini mendukung pemfilteran.
CanGroup	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi ini mendukung pengelompokan.
CanSort	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi ini mendukung pengurutan.
Comparer	Mengembalikan objek yang bisa Anda gunakan untuk membandingkan item dalam tampilan. (Diperoleh dari CollectionView)
Count	Mendapatkan jumlah rekaman dalam koleksi.
Culture	Mendapatkan atau mengatur informasi budaya yang akan digunakan selama pengurutan. (Diperoleh dari CollectionView)
CurrentItem	Mendapatkan item saat ini dalam tampilan.
CurrentPosition	Mendapatkan posisi ordinal item saat ini dalam tampilan.
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
Filter	Mendapatkan atau mengatur panggilan balik yang digunakan untuk menentukan apakah item cocok untuk dimasukkan dalam tampilan.
GroupDescriptions	Mendapatkan kumpulan GroupDescription objek yang menentukan cara mengelompokkan item.
Groups	Mendapatkan grup tingkat atas yang dibangun sesuai dengan GroupDescriptions.
IsCurrentAfterLast	Mendapatkan nilai yang menunjukkan apakah item tampilan saat ini berada di luar akhir koleksi.
IsCurrentBeforeFirst	Mendapatkan nilai yang menunjukkan apakah item tampilan saat ini berada di luar awal koleksi.
IsCurrentInSync	Mendapatkan nilai yang menunjukkan apakah CurrentItem ada di CurrentPosition. (Diperoleh dari CollectionView)
IsDynamic	Mendapatkan nilai yang menunjukkan apakah koleksi yang mendasar menyediakan pemberitahuan perubahan. (Diperoleh dari CollectionView)
IsEmpty	Mendapatkan nilai yang menunjukkan apakah tampilan yang dihasilkan (difilter) kosong.
IsInUse	Mendapatkan nilai yang menunjukkan apakah ada objek yang berlangganan peristiwa ini CollectionView. (Diperoleh dari CollectionView)
IsLiveFiltering	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pemfilteran data secara real time diaktifkan.
IsLiveGrouping	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengelompokan data secara real time diaktifkan.
IsLiveSorting	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengurutan secara real time diaktifkan.
IsRefreshDeferred	Mendapatkan nilai yang menunjukkan apakah ada penggunaan yang luar biasa DeferRefresh() . (Diperoleh dari CollectionView)
Item[Int32]	Mendapatkan atau mengatur item pada indeks berbasis nol yang diberikan.
LiveFilteringProperties	Mendapatkan kumpulan string yang menentukan properti yang berpartisipasi dalam pemfilteran data secara real time.
LiveGroupingProperties	Mendapatkan kumpulan string yang menentukan properti yang berpartisipasi dalam pengelompokan data secara real time.
LiveSortingProperties	Mendapatkan kumpulan string yang menentukan properti yang berpartisipasi dalam pengurutan data secara real time.
NeedsRefresh	Mendapatkan nilai yang menunjukkan apakah koleksi perlu di-refresh.
SortDescriptions	Mendapatkan kumpulan SortDescription objek yang menjelaskan bagaimana item dalam koleksi diurutkan dalam tampilan.
SourceCollection	Mendapatkan koleksi yang tidak diurutkan dan tidak difilter yang mendasar tampilan koleksi ini.
UpdatedOutsideDispatcher	Mendapatkan nilai yang menunjukkan apakah perlu memperbarui log perubahan karena CollectionChanged pemberitahuan telah diterima pada utas yang berbeda tanpa terlebih dahulu memasukkan dispatcher utas antarmuka pengguna (UI). (Diperoleh dari CollectionView)

Metode

Add(Object)	Menambahkan item ke ItemCollection.
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
Clear()	Menghapus koleksi dan merilis referensi pada semua item yang saat ini ada dalam koleksi.
ClearChangeLog()	Kedaluwarsa. Menghapus perubahan yang tertunda dari log perubahan. (Diperoleh dari CollectionView)
ClearPendingChanges()	Menghapus perubahan yang tidak diolah ke koleksi. (Diperoleh dari CollectionView)
Contains(Object)	Mengembalikan nilai yang menunjukkan apakah item yang ditentukan ada dalam tampilan ini.
CopyTo(Array, Int32)	Menyalin elemen koleksi ke array, dimulai dari indeks array tertentu.
DeferRefresh()	Memasukkan siklus tunda yang dapat Anda gunakan untuk menggabungkan perubahan pada tampilan dan menunda refresh otomatis.
DetachFromSourceCollection()	Menghapus referensi ke koleksi yang mendasar dari CollectionView. (Diperoleh dari CollectionView)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetEnumerator()	Mengembalikan objek yang bisa Anda gunakan untuk menghitung item dalam tampilan. (Diperoleh dari CollectionView)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetItemAt(Int32)	Mengembalikan item pada indeks berbasis nol yang ditentukan dalam tampilan ini.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IndexOf(Object)	Mengembalikan indeks dalam koleksi ini tempat item yang ditentukan berada.
Insert(Int32, Object)	Menyisipkan elemen ke dalam koleksi pada indeks yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MoveCurrentTo(Object)	Mengatur item yang ditentukan dalam koleksi sebagai CurrentItem.
MoveCurrentToFirst()	Mengatur item pertama dalam tampilan sebagai CurrentItem.
MoveCurrentToLast()	Mengatur item terakhir dalam tampilan sebagai CurrentItem.
MoveCurrentToNext()	Mengatur item setelah CurrentItem dalam tampilan sebagai CurrentItem.
MoveCurrentToPosition(Int32)	Mengatur item pada indeks yang ditentukan menjadi CurrentItem dalam tampilan.
MoveCurrentToPrevious()	Mengatur item sebelum CurrentItem dalam tampilan sebagai CurrentItem.
OKToChangeCurrent()	Mengembalikan nilai yang menunjukkan apakah tampilan dapat mengubah item mana yang merupakan CurrentItem. (Diperoleh dari CollectionView)
OnAllowsCrossThreadChangesChanged()	Terjadi saat AllowsCrossThreadChanges properti berubah. (Diperoleh dari CollectionView)
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Kedaluwarsa. Dipanggil oleh kelas dasar untuk memberi tahu kelas turunan bahwa suatu CollectionChanged peristiwa telah diposting ke antrean pesan. (Diperoleh dari CollectionView)
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Memunculkan kejadian CollectionChanged. (Diperoleh dari CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Memunculkan kejadian CollectionChanged. (Diperoleh dari CollectionView)
OnCurrentChanged()	Memunculkan kejadian CurrentChanged. (Diperoleh dari CollectionView)
OnCurrentChanging()	CurrentChanging Menaikkan acara yang tidak dapat dibatalkan. (Diperoleh dari CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)	Menaikkan CurrentChanging peristiwa dengan argumen yang ditentukan. (Diperoleh dari CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)	Menaikkan PropertyChanged peristiwa menggunakan argumen yang ditentukan. (Diperoleh dari CollectionView)
PassesFilter(Object)	Mengembalikan nilai yang menunjukkan apakah item yang ditentukan milik tampilan ini.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	Saat ditimpa di kelas turunan, memproses satu perubahan pada utas UI. (Diperoleh dari CollectionView)
ProcessPendingChanges()	Memastikan bahwa semua perubahan yang tertunda pada koleksi telah diterapkan. (Diperoleh dari CollectionView)
Refresh()	Membuat ulang tampilan. (Diperoleh dari CollectionView)
RefreshOrDefer()	Merefresh tampilan atau menentukan bahwa tampilan perlu disegarkan saat siklus penangguh selesai. (Diperoleh dari CollectionView)
RefreshOverride()	Membuat ulang tampilan. (Diperoleh dari CollectionView)
Remove(Object)	Menghapus referensi item yang ditentukan dari koleksi atau tampilan.
RemoveAt(Int32)	Menghapus item pada indeks koleksi atau tampilan yang ditentukan.
SetCurrent(Object, Int32)	Mengatur item dan indeks yang ditentukan sebagai nilai CurrentItem properti dan CurrentPosition . (Diperoleh dari CollectionView)
SetCurrent(Object, Int32, Int32)	Mengatur item dan indeks yang ditentukan sebagai nilai CurrentItem properti dan CurrentPosition . Metode ini dapat dipanggil dari konstruktor kelas turunan. (Diperoleh dari CollectionView)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Acara

CollectionChanged	Terjadi ketika tampilan telah berubah. (Diperoleh dari CollectionView)
CurrentChanged	Terjadi setelah CurrentItem berubah. (Diperoleh dari CollectionView)
CurrentChanging	Terjadi ketika CurrentItem berubah. (Diperoleh dari CollectionView)
PropertyChanged	Terjadi ketika nilai properti telah berubah. (Diperoleh dari CollectionView)

Implementasi Antarmuka Eksplisit

ICollection.IsSynchronized	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
ICollection.SyncRoot	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
IEditableCollectionView.AddNew()	Menambahkan item baru ke koleksi.
IEditableCollectionView.CanAddNew	Mendapatkan nilai yang menunjukkan apakah item baru dapat ditambahkan ke koleksi.
IEditableCollectionView.CanCancelEdit	Mendapatkan nilai yang menunjukkan apakah tampilan koleksi dapat membuang perubahan yang tertunda dan memulihkan nilai asli objek yang diedit.
IEditableCollectionView.CancelEdit()	Mengakhiri transaksi edit dan, jika memungkinkan, memulihkan nilai asli ke item.
IEditableCollectionView.CancelNew()	Mengakhiri transaksi add dan membuang item baru yang tertunda.
IEditableCollectionView.CanRemove	Mendapatkan nilai yang menunjukkan apakah item dapat dihapus dari koleksi.
IEditableCollectionView.CommitEdit()	Mengakhiri transaksi edit dan menyimpan perubahan yang tertunda.
IEditableCollectionView.CommitNew()	Mengakhiri transaksi tambahkan dan menyimpan item baru yang tertunda.
IEditableCollectionView.CurrentAddItem	Mendapatkan item yang sedang ditambahkan selama tambahkan transaksi saat ini.
IEditableCollectionView.CurrentEditItem	Mendapatkan item dalam koleksi yang sedang diedit.
IEditableCollectionView.EditItem(Object)	Memulai transaksi edit item yang ditentukan.
IEditableCollectionView.IsAddingNew	Mendapatkan nilai yang menunjukkan apakah transaksi add sedang berlangsung.
IEditableCollectionView.IsEditingItem	Mendapatkan nilai yang menunjukkan apakah transaksi edit sedang berlangsung.
IEditableCollectionView.NewItemPlaceholderPosition	Mendapatkan atau mengatur posisi tempat penampung item baru dalam tampilan koleksi.
IEditableCollectionView.Remove(Object)	Menghapus item yang ditentukan dari koleksi.
IEditableCollectionView.RemoveAt(Int32)	Menghapus item pada posisi yang ditentukan dari koleksi.
IEditableCollectionViewAddNewItem.AddNewItem(Object)	Menambahkan objek yang ditentukan ke koleksi.
IEditableCollectionViewAddNewItem.CanAddNewItem	Mendapatkan nilai yang menunjukkan apakah objek tertentu dapat ditambahkan ke koleksi.
IEnumerable.GetEnumerator()	Mengembalikan IEnumerator objek yang bisa Anda gunakan untuk menghitung item dalam tampilan. (Diperoleh dari CollectionView)
IItemProperties.ItemProperties	Mendapatkan koleksi yang berisi informasi tentang properti yang tersedia pada item dalam koleksi.
IList.IsFixedSize	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
IList.IsReadOnly	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda.
INotifyCollectionChanged.CollectionChanged	Terjadi ketika tampilan telah berubah. (Diperoleh dari CollectionView)
INotifyPropertyChanged.PropertyChanged	Terjadi saat nilai properti berubah. (Diperoleh dari CollectionView)
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)	Menerima peristiwa dari manajer peristiwa terpusat.

Metode Ekstensi

Lihat juga

• ItemsControl