Bagikan melalui


ItemCollection Kelas

Definisi

Menyimpan daftar item yang merupakan konten dari ItemsControl.

public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
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.IEditableCollectionView, 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.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 IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionView
    interface IItemProperties
    interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface IItemProperties
    interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
    inherit CollectionView
    interface IList
    interface ICollection
    interface IEnumerable
    interface IEditableCollectionViewAddNewItem
    interface IEditableCollectionView
    interface ICollectionViewLiveShaping
    interface IItemProperties
    interface 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 IEditableCollectionView, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
Warisan
Atribut
Penerapan

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.

ItemCollection CollectionView 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

Cast<TResult>(IEnumerable)

Mentransmisikan elemen dari IEnumerable ke jenis yang ditentukan.

OfType<TResult>(IEnumerable)

Memfilter elemen berdasarkan IEnumerable jenis tertentu.

AsParallel(IEnumerable)

Mengaktifkan paralelisasi kueri.

AsQueryable(IEnumerable)

Mengonversi menjadi IEnumerableIQueryable.

Berlaku untuk

Lihat juga