ItemCollection Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Bevat de lijst met items die de inhoud van een 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
- Overname
- Kenmerken
- Implementeringen
Voorbeelden
Als u een ItemsControl, zoals een ListBox met inhoud, hebt, kunt u de Items eigenschap gebruiken om toegang te krijgen tot de ItemCollection, wat een weergave is. Omdat het een weergave is, kunt u vervolgens de functies voor weergaven gebruiken, zoals sorteren, filteren en groeperen. Houd er rekening mee dat wanneer ItemsSource is ingesteld, de weergavebewerkingen delegeren aan de weergave over de verzameling ItemsBron. Daarom ondersteunt ItemCollection alleen sorteren, filteren en groeperen als de gedelegeerde weergave deze ondersteunt.
In het volgende voorbeeld ziet u hoe u de inhoud van een ListBox benoemde naam myListBoxsorteert. In dit voorbeeld Content is de naam van de eigenschap waarop moet worden gesorteerd.
myListBox.Items.SortDescriptions.Add(
new SortDescription("Content", ListSortDirection.Descending));
myListBox.Items.SortDescriptions.Add(New SortDescription("Content", ListSortDirection.Descending))
Wanneer u dit doet, is de weergave mogelijk of niet de standaardweergave, afhankelijk van hoe de gegevens zijn ingesteld op uw ItemsControl. Wanneer de ItemsSource eigenschap bijvoorbeeld is gebonden aan een CollectionViewSource, is de weergave die u met de Items eigenschap verkrijgt niet de standaardweergave.
Als uw ItemsControl afhankelijk is (u gebruikt de ItemsSource eigenschap), kunt u het volgende doen om de standaardweergave op te halen:
CollectionView myView;
Private myView As CollectionView
myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);
myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)
U kunt ook filter-, sorteer- en groeperingscriteria opgeven in XAML met behulp van CollectionViewSource.
Opmerkingen
ItemCollection onderhoudt een verzameling items, zoals tekenreeksen, objecten, XML-knooppunten, elementen en andere verzamelingen. Een ItemsControl gebruiker gebruikt de gegevens in de ItemCollection gegevens om de inhoud ervan te genereren. Als u meer dan één verzameling wilt aggregeren, wijst u een CompositeCollection toe aan de ItemsSource eigenschap van uw ItemsControl.
Gebruik de Items eigenschap of de ItemsSource eigenschap om de verzameling op te geven die moet worden gebruikt om de inhoud van uw ItemsControlbestand te genereren. Wanneer de ItemsSource eigenschap is ingesteld, wordt de Items verzameling alleen-lezen en vaste grootte gemaakt. Dit betekent dat als u de ItemsSource eigenschap gebruikt, u items niet rechtstreeks in de ItemCollection eigenschap kunt toevoegen, verwijderen of wijzigen.
ItemCollection is een CollectionView en biedt daarom functies voor het weergeven van verzamelingen, zoals sorteren, groeperen en filteren. Zie SortDescriptions, Filter en GroupDescriptions voor meer informatie.
Zie Overzicht van gegevensbinding voor meer informatie over verzamelingsweergaven.
Eigenschappen
| Name | Description |
|---|---|
| AllowsCrossThreadChanges |
Hiermee wordt een waarde opgehaald die aangeeft of een andere thread dan de thread die de thread heeft gemaakt, CollectionView de SourceCollectionwaarde kan wijzigen. (Overgenomen van CollectionView) |
| CanChangeLiveFiltering |
Hiermee wordt een waarde opgehaald die aangeeft of de verzamelingsweergave ondersteuning biedt voor het in- of uitschakelen van filtergegevens. |
| CanChangeLiveGrouping |
Hiermee wordt een waarde opgehaald die aangeeft of de verzamelingsweergave ondersteuning biedt voor het in- of uitschakelen van groeperingsgegevens. |
| CanChangeLiveSorting |
Hiermee wordt een waarde opgehaald die aangeeft of de verzamelingsweergave ondersteuning biedt voor het in- of uitschakelen van sorteergegevens. |
| CanFilter |
Hiermee wordt een waarde opgehaald die aangeeft of deze verzamelingsweergave filteren ondersteunt. |
| CanGroup |
Hiermee wordt een waarde opgehaald die aangeeft of deze verzamelingsweergave groepering ondersteunt. |
| CanSort |
Hiermee wordt een waarde opgehaald die aangeeft of deze verzamelingsweergave sorteerbewerkingen ondersteunt. |
| Comparer |
Retourneert een object dat u kunt gebruiken om items in de weergave te vergelijken. (Overgenomen van CollectionView) |
| Count |
Hiermee haalt u het aantal records in de verzameling op. |
| Culture |
Hiermee haalt u de cultuurinformatie op of stelt u deze in voor gebruik tijdens het sorteren. (Overgenomen van CollectionView) |
| CurrentItem |
Hiermee wordt het huidige item in de weergave opgeslagen. |
| CurrentPosition |
Hiermee haalt u de rangschikkpositie van het huidige item in de weergave op. |
| Dispatcher |
Hiermee wordt de Dispatcher aan dit DispatcherObject gekoppelde bestand. (Overgenomen van DispatcherObject) |
| Filter |
Hiermee haalt u een callback op die wordt gebruikt om te bepalen of een item geschikt is voor opname in de weergave. |
| GroupDescriptions |
Hiermee haalt u een verzameling GroupDescription objecten op waarmee wordt gedefinieerd hoe u de items kunt groeperen. |
| Groups |
Hiermee haalt u de groepen op het hoogste niveau op die volgens de GroupDescriptions. |
| IsCurrentAfterLast |
Hiermee wordt een waarde opgehaald die aangeeft of het huidige item van de weergave buiten het einde van de verzameling valt. |
| IsCurrentBeforeFirst |
Hiermee wordt een waarde opgehaald die aangeeft of het huidige item van de weergave buiten het begin van de verzameling valt. |
| IsCurrentInSync |
Hiermee wordt een waarde opgehaald die aangeeft of de CurrentItem waarde zich op de CurrentPosition. (Overgenomen van CollectionView) |
| IsDynamic |
Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende verzameling wijzigingsmeldingen biedt. (Overgenomen van CollectionView) |
| IsEmpty |
Hiermee wordt een waarde opgehaald die aangeeft of de resulterende (gefilterde) weergave leeg is. |
| IsInUse |
Hiermee wordt een waarde opgehaald die aangeeft of een object zich abonneert op de gebeurtenissen van dit CollectionViewobject. (Overgenomen van CollectionView) |
| IsLiveFiltering |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het filteren van gegevens in realtime is ingeschakeld. |
| IsLiveGrouping |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of groeperingsgegevens in realtime zijn ingeschakeld. |
| IsLiveSorting |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of sorteren in realtime is ingeschakeld. |
| IsRefreshDeferred |
Hiermee wordt een waarde opgehaald die aangeeft of er sprake is van een openstaand DeferRefresh() gebruik. (Overgenomen van CollectionView) |
| Item[Int32] |
Hiermee haalt u het item op of stelt u dit in op de opgegeven index op basis van nul. |
| LiveFilteringProperties |
Hiermee haalt u een verzameling tekenreeksen op die de eigenschappen opgeven die in realtime deelnemen aan het filteren van gegevens. |
| LiveGroupingProperties |
Hiermee haalt u een verzameling tekenreeksen op die de eigenschappen opgeven die in realtime deelnemen aan het groeperen van gegevens. |
| LiveSortingProperties |
Hiermee haalt u een verzameling tekenreeksen op waarmee de eigenschappen worden opgegeven die in realtime deelnemen aan het sorteren van gegevens. |
| NeedsRefresh |
Hiermee wordt een waarde opgehaald die aangeeft of de verzameling moet worden vernieuwd. |
| SortDescriptions |
Hiermee haalt u een verzameling SortDescription objecten op die beschrijven hoe de items in de verzameling in de weergave worden gesorteerd. |
| SourceCollection |
Hiermee haalt u de niet-gesorteerde en niet-gefilterde verzameling op die ten grondslag komt aan deze verzamelingsweergave. |
| UpdatedOutsideDispatcher |
Hiermee wordt een waarde opgehaald die aangeeft of het nodig is om het wijzigingslogboek bij te werken, omdat er een CollectionChanged melding is ontvangen op een andere thread zonder eerst de thread-dispatcher van de gebruikersinterface (UI) in te voeren. (Overgenomen van CollectionView) |
Methoden
| Name | Description |
|---|---|
| Add(Object) |
Voegt een item toe aan de ItemCollection. |
| CheckAccess() |
Bepaalt of de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject) |
| Clear() |
Hiermee wist u de verzameling en worden de verwijzingen vrijgegeven voor alle items die zich momenteel in de verzameling bevinden. |
| ClearChangeLog() |
Verouderd.
Hiermee wist u alle wijzigingen die in behandeling zijn in het wijzigingenlogboek. (Overgenomen van CollectionView) |
| ClearPendingChanges() |
Hiermee wist u niet-verwerkte wijzigingen in de verzameling. (Overgenomen van CollectionView) |
| Contains(Object) |
Retourneert een waarde die aangeeft of het opgegeven item zich in deze weergave bevindt. |
| CopyTo(Array, Int32) |
Kopieert de elementen van de verzameling naar een matrix, beginnend bij een bepaalde matrixindex. |
| DeferRefresh() |
Hiermee voert u een vertragingscyclus in die u kunt gebruiken om wijzigingen samen te voegen in de weergave en het automatisch vernieuwen uit te stellen. |
| DetachFromSourceCollection() |
Hiermee verwijdert u de verwijzing naar de onderliggende verzameling uit de CollectionView. (Overgenomen van CollectionView) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetEnumerator() |
Hiermee wordt een object geretourneerd dat u kunt gebruiken om de items in de weergave op te sommen. (Overgenomen van CollectionView) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetItemAt(Int32) |
Retourneert het item in de opgegeven op nul gebaseerde index in deze weergave. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IndexOf(Object) |
Retourneert de index in deze verzameling waar het opgegeven item zich bevindt. |
| Insert(Int32, Object) |
Hiermee voegt u een element in de verzameling in de opgegeven index in. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MoveCurrentTo(Object) |
Hiermee stelt u het opgegeven item in de verzameling in als de CurrentItem. |
| MoveCurrentToFirst() |
Hiermee stelt u het eerste item in de weergave in als de CurrentItem. |
| MoveCurrentToLast() |
Hiermee stelt u het laatste item in de weergave in als de CurrentItem. |
| MoveCurrentToNext() |
Hiermee stelt u het item na de CurrentItem in de weergave in als de CurrentItem. |
| MoveCurrentToPosition(Int32) |
Hiermee stelt u het item op de opgegeven index in als de CurrentItem weergave. |
| MoveCurrentToPrevious() |
Hiermee stelt u het item in voor de CurrentItem weergave als de CurrentItem. |
| OKToChangeCurrent() |
Retourneert een waarde die aangeeft of de weergave het item kan CurrentItemwijzigen. (Overgenomen van CollectionView) |
| OnAllowsCrossThreadChangesChanged() |
Treedt op wanneer de AllowsCrossThreadChanges eigenschap wordt gewijzigd. (Overgenomen van CollectionView) |
| OnBeginChangeLogging(NotifyCollectionChangedEventArgs) |
Verouderd.
Aangeroepen door de basisklasse om de afgeleide klasse op de hoogte te stellen dat een CollectionChanged gebeurtenis is gepost in de berichtenwachtrij. (Overgenomen van CollectionView) |
| OnCollectionChanged(NotifyCollectionChangedEventArgs) |
Hiermee wordt de CollectionChanged gebeurtenis gegenereerd. (Overgenomen van CollectionView) |
| OnCollectionChanged(Object, NotifyCollectionChangedEventArgs) |
Hiermee wordt de CollectionChanged gebeurtenis gegenereerd. (Overgenomen van CollectionView) |
| OnCurrentChanged() |
Hiermee wordt de CurrentChanged gebeurtenis gegenereerd. (Overgenomen van CollectionView) |
| OnCurrentChanging() |
Hiermee wordt een CurrentChanging gebeurtenis gegenereerd die niet kan worden geannuleerd. (Overgenomen van CollectionView) |
| OnCurrentChanging(CurrentChangingEventArgs) |
Hiermee wordt de CurrentChanging gebeurtenis met de opgegeven argumenten gegenereerd. (Overgenomen van CollectionView) |
| OnPropertyChanged(PropertyChangedEventArgs) |
Hiermee wordt de PropertyChanged gebeurtenis gegenereerd met behulp van de opgegeven argumenten. (Overgenomen van CollectionView) |
| PassesFilter(Object) |
Retourneert een waarde die aangeeft of het opgegeven item deel uitmaakt van deze weergave. |
| ProcessCollectionChanged(NotifyCollectionChangedEventArgs) |
Wanneer deze wordt overschreven in een afgeleide klasse, verwerkt u één wijziging in de UI-thread. (Overgenomen van CollectionView) |
| ProcessPendingChanges() |
Zorgt ervoor dat alle wijzigingen die in behandeling zijn in de verzameling zijn doorgevoerd. (Overgenomen van CollectionView) |
| Refresh() |
Hiermee maakt u de weergave opnieuw. (Overgenomen van CollectionView) |
| RefreshOrDefer() |
Vernieuwt de weergave of geeft aan dat de weergave moet worden vernieuwd wanneer de cyclus voor uitstellen is voltooid. (Overgenomen van CollectionView) |
| RefreshOverride() |
Hiermee maakt u de weergave opnieuw. (Overgenomen van CollectionView) |
| Remove(Object) |
Hiermee verwijdert u de opgegeven itemreferentie uit de verzameling of weergave. |
| RemoveAt(Int32) |
Hiermee verwijdert u het item in de opgegeven index van de verzameling of weergave. |
| SetCurrent(Object, Int32, Int32) |
Hiermee stelt u het opgegeven item en de index in als de waarden van de CurrentItem en CurrentPosition eigenschappen. Deze methode kan worden aangeroepen vanuit een constructor van een afgeleide klasse. (Overgenomen van CollectionView) |
| SetCurrent(Object, Int32) |
Hiermee stelt u het opgegeven item en de index in als de waarden van de CurrentItem en CurrentPosition eigenschappen. (Overgenomen van CollectionView) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| VerifyAccess() |
Hiermee wordt afgedwongen dat de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject) |
gebeurtenis
| Name | Description |
|---|---|
| CollectionChanged |
Treedt op wanneer de weergave is gewijzigd. (Overgenomen van CollectionView) |
| CurrentChanged |
Treedt op nadat de CurrentItem wijziging is doorgevoerd. (Overgenomen van CollectionView) |
| CurrentChanging |
Treedt op wanneer het CurrentItem verandert. (Overgenomen van CollectionView) |
| PropertyChanged |
Treedt op wanneer een eigenschapswaarde is gewijzigd. (Overgenomen van CollectionView) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| ICollection.IsSynchronized |
Dit lid ondersteunt de Windows Presentation Foundation -infrastructuur (WPF) en is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt. |
| ICollection.SyncRoot |
Dit lid ondersteunt de Windows Presentation Foundation -infrastructuur (WPF) en is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt. |
| IEditableCollectionView.AddNew() |
Hiermee voegt u een nieuw item toe aan de verzameling. |
| IEditableCollectionView.CanAddNew |
Hiermee wordt een waarde opgehaald die aangeeft of een nieuw item aan de verzameling kan worden toegevoegd. |
| IEditableCollectionView.CanCancelEdit |
Hiermee wordt een waarde opgehaald die aangeeft of de verzamelingsweergave wijzigingen in behandeling kan negeren en de oorspronkelijke waarden van een bewerkt object kan herstellen. |
| IEditableCollectionView.CancelEdit() |
Hiermee beëindigt u de bewerkingstransactie en herstelt u, indien mogelijk, de oorspronkelijke waarde naar het item. |
| IEditableCollectionView.CancelNew() |
Hiermee wordt de transactie voor toevoegen beëindigd en wordt het in behandeling zijnde nieuwe item verwijderd. |
| IEditableCollectionView.CanRemove |
Hiermee wordt een waarde opgehaald die aangeeft of een item uit de verzameling kan worden verwijderd. |
| IEditableCollectionView.CommitEdit() |
Hiermee wordt de bewerkingstransactie beëindigd en worden de wijzigingen in behandeling opgeslagen. |
| IEditableCollectionView.CommitNew() |
Hiermee wordt de transactie voor toevoegen beëindigd en wordt het nieuwe item in behandeling opgeslagen. |
| IEditableCollectionView.CurrentAddItem |
Hiermee haalt u het item op dat wordt toegevoegd tijdens de huidige transactie voor toevoegen. |
| IEditableCollectionView.CurrentEditItem |
Hiermee haalt u het item op in de verzameling die wordt bewerkt. |
| IEditableCollectionView.EditItem(Object) |
Hiermee begint u een bewerkingstransactie van het opgegeven item. |
| IEditableCollectionView.IsAddingNew |
Hiermee wordt een waarde opgehaald die aangeeft of een add-transactie wordt uitgevoerd. |
| IEditableCollectionView.IsEditingItem |
Hiermee wordt een waarde opgehaald die aangeeft of een bewerkingstransactie wordt uitgevoerd. |
| IEditableCollectionView.NewItemPlaceholderPosition |
Hiermee haalt u de positie van de tijdelijke aanduiding voor het nieuwe item in de verzamelingsweergave op of stelt u deze in. |
| IEditableCollectionView.Remove(Object) |
Hiermee verwijdert u het opgegeven item uit de verzameling. |
| IEditableCollectionView.RemoveAt(Int32) |
Hiermee verwijdert u het item op de opgegeven positie uit de verzameling. |
| IEditableCollectionViewAddNewItem.AddNewItem(Object) |
Hiermee voegt u het opgegeven object toe aan de verzameling. |
| IEditableCollectionViewAddNewItem.CanAddNewItem |
Hiermee wordt een waarde opgehaald die aangeeft of een opgegeven object kan worden toegevoegd aan de verzameling. |
| IEnumerable.GetEnumerator() |
Hiermee wordt een IEnumerator object geretourneerd dat u kunt gebruiken om de items in de weergave op te sommen. (Overgenomen van CollectionView) |
| IItemProperties.ItemProperties |
Hiermee haalt u een verzameling op die informatie bevat over de eigenschappen die beschikbaar zijn voor de items in een verzameling. |
| IList.IsFixedSize |
Dit lid ondersteunt de Windows Presentation Foundation -infrastructuur (WPF) en is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt. |
| IList.IsReadOnly |
Dit lid ondersteunt de Windows Presentation Foundation -infrastructuur (WPF) en is niet bedoeld om rechtstreeks vanuit uw code te worden gebruikt. |
| INotifyCollectionChanged.CollectionChanged |
Treedt op wanneer de weergave is gewijzigd. (Overgenomen van CollectionView) |
| INotifyPropertyChanged.PropertyChanged |
Treedt op wanneer een eigenschapswaarde wordt gewijzigd. (Overgenomen van CollectionView) |
| IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs) |
Ontvangt gebeurtenissen van de gecentraliseerde gebeurtenisbeheerder. |
Extensiemethoden
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Hiermee schakelt u parallelle uitvoering van een query in. |
| AsQueryable(IEnumerable) |
Converteert een IEnumerable naar een IQueryable. |
| Cast<TResult>(IEnumerable) |
Cast de elementen van een IEnumerable naar het opgegeven type. |
| OfType<TResult>(IEnumerable) |
Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type. |