ItemCollection Sınıf

Tanım

Ad Alanı:

System.Windows.Controls

Bütünleştirilmiş Kod:

PresentationFramework.dll

bir öğesinin içeriğini ItemsControloluşturan öğelerin listesini tutar.

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

Devralma

Object

DispatcherObject

CollectionView

ItemCollection

Öznitelikler

LocalizabilityAttribute

Uygulamalar

ICollection IEnumerable IList IEditableCollectionView IItemProperties IWeakEventListener IEditableCollectionViewAddNewItem ICollectionViewLiveShaping

Örnekler

İçeriği olan gibi bir ItemsControlListBox öğesiniz varsa, bir görünüm olan öğesine erişmek ItemCollectioniçin özelliğini kullanabilirsinizItems. Bu bir görünüm olduğundan sıralama, filtreleme ve gruplandırma gibi görünümle ilgili işlevleri kullanabilirsiniz. ItemsSource ayarlandığında, görünüm işlemlerinin ItemsSource koleksiyonu üzerinden görünüme temsilci olarak atandığını unutmayın. Bu nedenle, ItemCollection sıralamayı, filtrelemeyi ve gruplandırma işlemini yalnızca temsilci görünümü destekliyorsa destekler.

Aşağıdaki örnek, adlandırılmış myListBoxbir ListBox öğesinin içeriğinin nasıl sıralanacağını gösterir. Bu örnekte, Content sıralama ölçütü olarak özelliğinin adıdır.

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

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

Bunu yaptığınızda, verilerin üzerinde ItemsControlnasıl ayarlandıklarına bağlı olarak görünüm varsayılan görünüm olabilir veya olmayabilir. Örneğin, özelliği bir CollectionViewSourceöğesine bağlı olduğundaItemsSource, özelliğini kullanarak Items elde ettiğiniz görünüm varsayılan görünüm değildir.

bağlıysa ItemsControl (özelliğini kullanıyorsanız ItemsSource ), varsayılan görünümü almak için aşağıdakileri yapabilirsiniz:

CollectionView myView;

Private myView As CollectionView

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

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

Alternatif olarak, kullanarak CollectionViewSourceXAML'de filtreleme, sıralama ve gruplandırma ölçütlerini belirtebilirsiniz.

Açıklamalar

ItemCollection dizeler, nesneler, XML düğümleri, öğeler ve diğer koleksiyonlar gibi öğelerden oluşan bir koleksiyon tutar. , ItemsControl içeriğini oluşturmak için içindeki ItemCollection verileri kullanır. Birden fazla koleksiyonu toplamak istiyorsanız, öğesini özelliğine ItemsSourceItemsControlatayınCompositeCollection.

öğesinin Items içeriğini ItemsControloluşturmak için kullanılması gereken koleksiyonu belirtmek için özelliğini veya ItemsSource özelliğini kullanın. ItemsSource Özellik ayarlandığında, Items koleksiyon salt okunur ve sabit boyutlu yapılır. Bu, özelliğini kullanıyorsanız ItemsSource doğrudan içindeki öğeleri ekleyemeyeceğiniz, silemeyeceğiniz veya değiştiremeyeceğiniz ItemCollection anlamına gelir.

ItemCollection ve CollectionView bu nedenle sıralama, gruplandırma ve filtreleme gibi koleksiyon görünümü işlevleri sağlar. Daha fazla bilgi için bkz. SortDescriptions, Filter ve GroupDescriptions.

Koleksiyon görünümleri hakkında daha fazla bilgi için bkz. Veri Bağlamaya Genel Bakış.

Özellikler

AllowsCrossThreadChanges	öğesini oluşturandan CollectionView başka bir iş parçacığının öğesini değiştirip değiştiremeyeceğini SourceCollectionbelirten bir değer alır. (Devralındığı yer: CollectionView)
CanChangeLiveFiltering	Koleksiyon görünümünün filtreleme verilerini gerçek zamanlı olarak açmayı veya kapatmayı destekleyip desteklemediğini gösteren bir değer alır.
CanChangeLiveGrouping	Koleksiyon görünümünün gruplandırma verilerini gerçek zamanlı olarak açmayı veya kapatmayı destekleyip desteklemediğini gösteren bir değer alır.
CanChangeLiveSorting	Koleksiyon görünümünün sıralama verilerini gerçek zamanlı olarak açmayı veya kapatmayı destekleyip desteklemediğini gösteren bir değer alır.
CanFilter	Bu koleksiyon görünümünün filtrelemeyi destekleyip desteklemediğini gösteren bir değer alır.
CanGroup	Bu koleksiyon görünümünün gruplandırma desteği olup olmadığını gösteren bir değer alır.
CanSort	Bu koleksiyon görünümünün sıralamayı destekleyip desteklemediğini gösteren bir değer alır.
Comparer	Görünümdeki öğeleri karşılaştırmak için kullanabileceğiniz bir nesne döndürür. (Devralındığı yer: CollectionView)
Count	Koleksiyondaki kayıt sayısını alır.
Culture	Sıralama sırasında kullanılacak kültür bilgilerini alır veya ayarlar. (Devralındığı yer: CollectionView)
CurrentItem	Görünümdeki geçerli öğeyi alır.
CurrentPosition	Geçerli öğenin görünümdeki sıra konumunu alır.
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğunu alır. (Devralındığı yer: DispatcherObject)
Filter	Öğenin görünüme dahil edilmeye uygun olup olmadığını belirlemek için kullanılan bir geri çağırmayı alır veya ayarlar.
GroupDescriptions	Öğelerin nasıl gruplandırıldığını tanımlayan bir nesne koleksiyonu GroupDescription alır.
Groups	öğesine göre GroupDescriptionsoluşturduğunuz en üst düzey grupları alır.
IsCurrentAfterLast	Görünümün geçerli öğesinin koleksiyonun sonunun ötesinde olup olmadığını gösteren bir değer alır.
IsCurrentBeforeFirst	Görünümün geçerli öğesinin koleksiyonun başlangıcının ötesinde olup olmadığını gösteren bir değer alır.
IsCurrentInSync	öğesinin konumunda CurrentPositionolup olmadığını CurrentItem belirten bir değer alır. (Devralındığı yer: CollectionView)
IsDynamic	Temel koleksiyonun değişiklik bildirimleri sağlayıp sağlamadığını gösteren bir değer alır. (Devralındığı yer: CollectionView)
IsEmpty	Sonuçta elde edilen (filtrelenmiş) görünümün boş olup olmadığını gösteren bir değer alır.
IsInUse	Herhangi bir nesnenin bu CollectionViewolaylara abone olup olmadığını gösteren bir değer alır. (Devralındığı yer: CollectionView)
IsLiveFiltering	Verileri gerçek zamanlı olarak filtrelemenin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
IsLiveGrouping	Verileri gerçek zamanlı olarak gruplandırma özelliğinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
IsLiveSorting	Gerçek zamanlı sıralamanın etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
IsRefreshDeferred	Kullanımda bekleyen DeferRefresh() bir değer olup olmadığını belirten bir değer alır. (Devralındığı yer: CollectionView)
Item[Int32]	Verilen sıfır tabanlı dizinde öğeyi alır veya ayarlar.
LiveFilteringProperties	Verileri gerçek zamanlı olarak filtrelemeye katılan özellikleri belirten dizelerden oluşan bir koleksiyon alır.
LiveGroupingProperties	Verileri gerçek zamanlı olarak gruplandırmada yer alan özellikleri belirten dizelerden oluşan bir koleksiyon alır.
LiveSortingProperties	Verileri gerçek zamanlı olarak sıralamaya katılan özellikleri belirten dizelerden oluşan bir koleksiyon alır.
NeedsRefresh	Koleksiyonun yenilenmesi gerekip gerekmediğini belirten bir değer alır.
SortDescriptions	Koleksiyondaki SortDescription öğelerin görünümde nasıl sıralandığını açıklayan bir nesne koleksiyonu alır.
SourceCollection	Bu koleksiyon görünümünün altında yer alan sıralanmamış ve filtrelenmemiş koleksiyonu alır.
UpdatedOutsideDispatcher	Önce kullanıcı arabirimi (UI) iş parçacığı dağıtıcısı girilmeden farklı bir iş parçacığında bir CollectionChanged bildirim alındığından, değişiklik günlüğünü güncelleştirmenin gerekli olup olmadığını belirten bir değer alır. (Devralındığı yer: CollectionView)

Yöntemler

Add(Object)	öğesine ItemCollectionbir öğe ekler.
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
Clear()	Koleksiyonu temizler ve şu anda koleksiyondaki tüm öğelerdeki başvuruları serbest bırakır.
ClearChangeLog()	Geçersiz. Bekleyen değişiklikleri değişiklik günlüğünden temizler. (Devralındığı yer: CollectionView)
ClearPendingChanges()	İşlenmemiş olan ve koleksiyona değiştirilenleri temizler. (Devralındığı yer: CollectionView)
Contains(Object)	Belirtilen öğenin bu görünümde olup olmadığını gösteren bir değer döndürür.
CopyTo(Array, Int32)	Koleksiyonun öğelerini belirli bir dizi dizininden başlayarak bir diziye kopyalar.
DeferRefresh()	Görünümdeki değişiklikleri birleştirmek ve otomatik yenilemeyi geciktirmek için kullanabileceğiniz bir erteleme döngüsü girer.
DetachFromSourceCollection()	temel alınan koleksiyona başvuruyu'ndan CollectionViewkaldırır. (Devralındığı yer: CollectionView)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetEnumerator()	Görünümdeki öğeleri listelemek için kullanabileceğiniz bir nesne döndürür. (Devralındığı yer: CollectionView)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetItemAt(Int32)	Bu görünümde belirtilen sıfır tabanlı dizindeki öğeyi döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IndexOf(Object)	Belirtilen öğenin bulunduğu koleksiyondaki dizini döndürür.
Insert(Int32, Object)	Belirtilen dizinde bulunan koleksiyona öğe ekler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MoveCurrentTo(Object)	Koleksiyonda belirtilen öğeyi olarak CurrentItemayarlar.
MoveCurrentToFirst()	Görünümdeki ilk öğeyi olarak CurrentItemayarlar.
MoveCurrentToLast()	Görünümdeki son öğeyi olarak CurrentItemayarlar.
MoveCurrentToNext()	görünümde öğesinden CurrentItem sonraki öğeyi olarak CurrentItemayarlar.
MoveCurrentToPosition(Int32)	Belirtilen dizindeki öğeyi görünümde olacak şekilde CurrentItem ayarlar.
MoveCurrentToPrevious()	Görünümdeki öğesinden önce CurrentItem öğesini olarak CurrentItemayarlar.
OKToChangeCurrent()	Görünümün öğesi olan öğeyi CurrentItemdeğiştirip değiştiremeyeceğini belirten bir değer döndürür. (Devralındığı yer: CollectionView)
OnAllowsCrossThreadChangesChanged()	Özellik değiştiğinde AllowsCrossThreadChanges gerçekleşir. (Devralındığı yer: CollectionView)
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Geçersiz. Türetilmiş sınıfa bir CollectionChanged olayın ileti kuyruğuna gönderildiğini bildirmek için temel sınıf tarafından çağrılır. (Devralındığı yer: CollectionView)
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Olayı tetikler CollectionChanged . (Devralındığı yer: CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Olayı tetikler CollectionChanged . (Devralındığı yer: CollectionView)
OnCurrentChanged()	Olayı tetikler CurrentChanged . (Devralındığı yer: CollectionView)
OnCurrentChanging()	İptal edilemeyen bir CurrentChanging olay tetikler. (Devralındığı yer: CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)	CurrentChanging Olayı belirtilen bağımsız değişkenlerle yükseltir. (Devralındığı yer: CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)	PropertyChanged Belirtilen bağımsız değişkenleri kullanarak olayı tetikler. (Devralındığı yer: CollectionView)
PassesFilter(Object)	Belirtilen öğenin bu görünüme ait olup olmadığını gösteren bir değer döndürür.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	Türetilmiş bir sınıfta geçersiz kılındığında, kullanıcı arabirimi iş parçacığında tek bir değişikliği işler. (Devralındığı yer: CollectionView)
ProcessPendingChanges()	Koleksiyonda bekleyen tüm değişikliklerin işlendiğini güvence altına alır. (Devralındığı yer: CollectionView)
Refresh()	Görünümü yeniden oluşturur. (Devralındığı yer: CollectionView)
RefreshOrDefer()	Görünümü yeniler veya erteleme döngüsü tamamlandığında görünümün yenilenmesi gerektiğini belirtir. (Devralındığı yer: CollectionView)
RefreshOverride()	Görünümü yeniden oluşturur. (Devralındığı yer: CollectionView)
Remove(Object)	Belirtilen öğe başvuruyu koleksiyondan veya görünümden kaldırır.
RemoveAt(Int32)	Koleksiyon veya görünümün belirtilen dizinindeki öğeyi kaldırır.
SetCurrent(Object, Int32)	Belirtilen öğeyi ve dizini ve CurrentPosition özelliklerinin değerleri CurrentItem olarak ayarlar. (Devralındığı yer: CollectionView)
SetCurrent(Object, Int32, Int32)	Belirtilen öğeyi ve dizini ve CurrentPosition özelliklerinin değerleri CurrentItem olarak ayarlar. Bu yöntem türetilmiş bir sınıfın oluşturucusundan çağrılabilir. (Devralındığı yer: CollectionView)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar. (Devralındığı yer: DispatcherObject)

Ekinlikler

CollectionChanged	Görünüm değiştiğinde gerçekleşir. (Devralındığı yer: CollectionView)
CurrentChanged	değiştirildikten sonra CurrentItem gerçekleşir. (Devralındığı yer: CollectionView)
CurrentChanging	değiştiğinde CurrentItem gerçekleşir. (Devralındığı yer: CollectionView)
PropertyChanged	Özellik değeri değiştiğinde gerçekleşir. (Devralındığı yer: CollectionView)

Belirtik Arabirim Kullanımları

ICollection.IsSynchronized	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
ICollection.SyncRoot	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
IEditableCollectionView.AddNew()	Koleksiyona yeni bir öğe ekler.
IEditableCollectionView.CanAddNew	Koleksiyona yeni bir öğe eklenip eklenemeyeceğini belirten bir değer alır.
IEditableCollectionView.CanCancelEdit	Koleksiyon görünümünün bekleyen değişiklikleri atıp atamayacağını ve düzenlenen bir nesnenin özgün değerlerini geri yükleyip geri yükleyemeyeceğini belirten bir değer alır.
IEditableCollectionView.CancelEdit()	Düzenleme işlemini sonlandırır ve mümkünse özgün değeri öğeye geri yükler.
IEditableCollectionView.CancelNew()	Ekleme işlemini sonlandırır ve bekleyen yeni öğeyi atar.
IEditableCollectionView.CanRemove	Bir öğenin koleksiyondan kaldırılıp kaldırılamayacağını belirten bir değer alır.
IEditableCollectionView.CommitEdit()	Düzenleme işlemini sonlandırır ve bekleyen değişiklikleri kaydeder.
IEditableCollectionView.CommitNew()	Ekleme işlemini sonlandırır ve bekleyen yeni öğeyi kaydeder.
IEditableCollectionView.CurrentAddItem	Geçerli ekleme işlemi sırasında eklenen öğeyi alır.
IEditableCollectionView.CurrentEditItem	Düzenlenmekte olan koleksiyondaki öğeyi alır.
IEditableCollectionView.EditItem(Object)	Belirtilen öğenin düzenleme işlemini başlatır.
IEditableCollectionView.IsAddingNew	Bir ekleme işleminin devam edip etmediğini gösteren bir değer alır.
IEditableCollectionView.IsEditingItem	Düzenleme işleminin devam edip etmediğini gösteren bir değer alır.
IEditableCollectionView.NewItemPlaceholderPosition	Koleksiyon görünümünde yeni öğe yer tutucusunun konumunu alır veya ayarlar.
IEditableCollectionView.Remove(Object)	Belirtilen öğeyi koleksiyondan kaldırır.
IEditableCollectionView.RemoveAt(Int32)	Belirtilen konumdaki öğeyi koleksiyondan kaldırır.
IEditableCollectionViewAddNewItem.AddNewItem(Object)	Belirtilen nesneyi koleksiyona ekler.
IEditableCollectionViewAddNewItem.CanAddNewItem	Belirtilen bir nesnenin koleksiyona eklenip eklenemeyeceğini belirten bir değer alır.
IEnumerable.GetEnumerator()	Görünümdeki öğeleri listelemek için kullanabileceğiniz bir IEnumerator nesne döndürür. (Devralındığı yer: CollectionView)
IItemProperties.ItemProperties	Bir koleksiyondaki öğelerde kullanılabilen özellikler hakkında bilgi içeren bir koleksiyon alır.
IList.IsFixedSize	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
IList.IsReadOnly	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.
INotifyCollectionChanged.CollectionChanged	Görünüm değiştiğinde gerçekleşir. (Devralındığı yer: CollectionView)
INotifyPropertyChanged.PropertyChanged	Özellik değeri değiştiğinde gerçekleşir. (Devralındığı yer: CollectionView)
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)	Merkezi olay yöneticisinden olayları alır.

Uzantı Metotları

Ayrıca bkz.

• ItemsControl