ItemCollection Sınıf

Tanım

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

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
Devralma
Öznitelikler
Uygulamalar

Ö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ı

Cast<TResult>(IEnumerable)

öğesinin IEnumerable öğelerini belirtilen türe atar.

OfType<TResult>(IEnumerable)

Bir öğesinin IEnumerable öğelerini belirtilen türe göre filtreler.

AsParallel(IEnumerable)

Sorgunun paralelleştirilmesini sağlar.

AsQueryable(IEnumerable)

bir IEnumerable öğesini öğesine IQueryabledönüştürür.

Şunlara uygulanır

Ayrıca bkz.