ItemCollection クラス

定義

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
継承
属性
実装

コンテンツを含む などの ListBox があるItemsControl場合は、 プロパティをItems使用して、 ビューである にItemCollectionアクセスできます。 ビューであるため、並べ替え、フィルター処理、グループ化などのビュー関連の機能を使用できます。 ItemsSource が設定されている場合、ビュー操作は ItemsSource コレクションのビューに委任されることに注意してください。 したがって、ItemCollection では、委任されたビューでサポートされている場合にのみ、並べ替え、フィルター処理、およびグループ化がサポートされます。

次の例は、 という名前myListBoxの のコンテンツを並べ替える方法をListBox示しています。 この例では、 Content は並べ替えの基準となるプロパティの名前です。

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

これを行う場合、データの設定方法 ItemsControlによっては、ビューが既定のビューになる場合とそうでない場合があります。 たとえば、 プロパティが ItemsSourceCollectionViewSourceバインドされている場合、 プロパティを使用して Items 取得するビューは既定のビューではありません。

ItemsControlがバインドされている場合 (プロパティをItemsSource使用している場合)、次の操作を実行して既定のビューを取得できます。

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

または、 を使用して XAML でフィルター処理、並べ替え、グループ化の条件を CollectionViewSource指定することもできます。

注釈

ItemCollection は、文字列、オブジェクト、XML ノード、要素、その他のコレクションなどの項目のコレクションを保持します。 では ItemsControl 、 の ItemCollection データを使用してそのコンテンツを生成します。 複数のコレクションを集計する場合は、 の プロパティItemsControlに をItemsSource割り当てますCompositeCollection

のコンテンツを Items 生成するために使用するコレクションを指定するには、 プロパティまたは ItemsSource プロパティを使用します ItemsControl。 プロパティを ItemsSource 設定すると、コレクションは Items 読み取り専用および固定サイズになります。 つまり、 プロパティを ItemsSource 使用している場合は、 内の ItemCollection 項目を直接追加、削除、または変更することはできません。

ItemCollectionCollectionViewは であるため、並べ替え、グループ化、フィルター処理などのコレクション ビュー機能が提供されます。 詳細については、「SortDescriptionsFilterおよび「GroupDescriptions」を参照してください。

コレクション ビューの詳細については、「 データ バインディングの概要」を参照してください。

プロパティ

AllowsCrossThreadChanges

CollectionView を作成したスレッド以外のスレッドが SourceCollection を変更できるかどうかを示す値を取得します。

(継承元 CollectionView)
CanChangeLiveFiltering

コレクション ビューがデータのリアルタイム フィルター処理のオン/オフ切り替えをサポートしているかどうかを示す値を取得します。

CanChangeLiveGrouping

コレクション ビューがリアルタイムのデータのグループ化のオンまたはオフをサポートするかどうかを示す値を取得します。

CanChangeLiveSorting

コレクション ビューがリアルタイムのデータの並べ替えのオンまたはオフをサポートするかどうかを示す値を取得します。

CanFilter

このコレクション ビューでフィルター処理がサポートされるかどうかを示す値を取得します。

CanGroup

このコレクション ビューでグループ化がサポートされるかどうかを示す値を取得します。

CanSort

このコレクション ビューで並べ替えがサポートされるかどうかを示す値を取得します。

Comparer

ビュー内の項目を比較するために使用できるオブジェクトを返します。

(継承元 CollectionView)
Count

コレクション内のレコード数を取得します。

Culture

並べ替え中に使用するカルチャ情報を取得または設定します。

(継承元 CollectionView)
CurrentItem

ビュー内の現在の項目を取得します。

CurrentPosition

ビュー内の現在の項目の位置を表す序数を取得します。

Dispatcher

この Dispatcher が関連付けられている DispatcherObject を取得します。

(継承元 DispatcherObject)
Filter

項目をビューに含めることが適切であるかどうかを決定するために使用されるコールバックを取得または設定します。

GroupDescriptions

項目をグループ化する方法を定義する GroupDescription オブジェクトのコレクションを取得します。

Groups

GroupDescriptions に従って構築されるトップレベル グループを取得します。

IsCurrentAfterLast

ビューの現在の項目がコレクションの末尾を越えるかどうかを示す値を取得します。

IsCurrentBeforeFirst

ビューの現在の項目がコレクションの先頭を越えるかどうかを示す値を取得します。

IsCurrentInSync

CurrentItemCurrentPosition にあるかどうかを示す値を取得します。

(継承元 CollectionView)
IsDynamic

基になるコレクションが変更通知機能を持つかどうかを示す値を取得します。

(継承元 CollectionView)
IsEmpty

結果の (フィルター処理された) ビューが空かどうかを示す値を取得します。

IsInUse

この CollectionView オブジェクトのイベントをサブスクライブしているオブジェクトがあるかどうかを示す値を取得します。

(継承元 CollectionView)
IsLiveFiltering

リアルタイムでのデータのフィルター処理が有効かどうかを示す値を取得または設定します。

IsLiveGrouping

リアルタイムでのデータのグループ化が有効かどうかを示す値を取得または設定します。

IsLiveSorting

リアルタイムでの並べ替えが有効かどうかを示す値を取得または設定します。

IsRefreshDeferred

保留状態の DeferRefresh() が使用されているかどうかを示す値を取得します。

(継承元 CollectionView)
Item[Int32]

指定された 0 から始まるインデックス位置にある項目を取得または設定します。

LiveFilteringProperties

リアルタイムのデータのフィルター選択に関係するプロパティを指定する文字列のコレクションを取得します。

LiveGroupingProperties

リアルタイムのデータのグループ化に関係するプロパティを指定する文字列のコレクションを取得します。

LiveSortingProperties

リアルタイムのデータの並べ替えに関係するプロパティを指定する文字列のコレクションを取得します。

NeedsRefresh

コレクションを更新する必要があるかどうかを示す値を取得します。

SortDescriptions

コレクション内の項目をビュー内でどのように並べ替えるかを説明する SortDescription オブジェクトのコレクションを取得します。

SourceCollection

このコレクション ビューの基になる、並べ替えおよびフィルター処理が行われていないコレクションを取得します。

UpdatedOutsideDispatcher

最初にユーザー インターフェイス (UI) スレッド ディスパッチャーに入らずに別のスレッドで通知を CollectionChanged 受信したために、変更ログを更新する必要があるかどうかを示す値を取得します。

(継承元 CollectionView)

メソッド

Add(Object)

ItemCollection に項目を追加します。

CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。

(継承元 DispatcherObject)
Clear()

コレクションを消去し、現在このコレクションに含まれているすべての項目に対する参照を解放します。

ClearChangeLog()
古い.

保留状態の変更を変更ログから消去します。

(継承元 CollectionView)
ClearPendingChanges()

コレクションに対する未処理の変更をクリアします。

(継承元 CollectionView)
Contains(Object)

指定された項目がこのビューに存在するかどうかを示す値を返します。

CopyTo(Array, Int32)

特定の配列インデックスを開始位置として、配列にコレクションの要素をコピーします。

DeferRefresh()

ビューの変更をマージして自動更新を遅延させるために使用できる遅延サイクルを入力します。

DetachFromSourceCollection()

基になるコレクションの参照を CollectionView から削除します。

(継承元 CollectionView)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetEnumerator()

ビュー内の項目を列挙するために使用できるオブジェクトを返します。

(継承元 CollectionView)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetItemAt(Int32)

このビュー内の、0 から始まる指定されたインデックス位置にある項目を返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IndexOf(Object)

指定された項目の位置を示す、このコレクション内のインデックスを返します。

Insert(Int32, Object)

要素をコレクション内の指定されたインデックス位置に挿入します。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MoveCurrentTo(Object)

コレクション内の指定された項目を CurrentItem として設定します。

MoveCurrentToFirst()

ビュー内の最初の項目を CurrentItem として設定します。

MoveCurrentToLast()

ビュー内の最後の項目を CurrentItem として設定します。

MoveCurrentToNext()

ビュー内の CurrentItem の後の項目を CurrentItemとして設定します。

MoveCurrentToPosition(Int32)

指定したインデックスにある項目を、ビュー内の CurrentItem になるように設定します。

MoveCurrentToPrevious()

ビュー内の CurrentItem の前にある項目を CurrentItem として設定します。

OKToChangeCurrent()

ビューで、CurrentItem である項目を変更できるかどうかを示す値を返します。

(継承元 CollectionView)
OnAllowsCrossThreadChangesChanged()

AllowsCrossThreadChanges プロパティが変更されたときに発生します。

(継承元 CollectionView)
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)
古い.

CollectionChanged イベントがメッセージ キューにポストされたことを派生クラスに通知するために、基本クラスによって呼び出されます。

(継承元 CollectionView)
OnCollectionChanged(NotifyCollectionChangedEventArgs)

CollectionChanged イベントを発生させます。

(継承元 CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)

CollectionChanged イベントを発生させます。

(継承元 CollectionView)
OnCurrentChanged()

CurrentChanged イベントを発生させます。

(継承元 CollectionView)
OnCurrentChanging()

キャンセルできない CurrentChanging イベントを発生させます。

(継承元 CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)

指定された引数を使用して、CurrentChanging イベントを発生させます。

(継承元 CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)

指定された引数を使用して PropertyChanged イベントを発生させます。

(継承元 CollectionView)
PassesFilter(Object)

指定された項目がこのビューに属しているかどうかを示す値を返します。

ProcessCollectionChanged(NotifyCollectionChangedEventArgs)

派生クラスでオーバーライドされると、UI スレッドで 1 つの変更を処理します。

(継承元 CollectionView)
ProcessPendingChanges()

コレクションへのすべての保留中の変更がコミットされたことを確認します。

(継承元 CollectionView)
Refresh()

ビューを再作成します。

(継承元 CollectionView)
RefreshOrDefer()

ビューを更新します。または遅延サイクルの完了時にビューを更新する必要があることを指定します。

(継承元 CollectionView)
RefreshOverride()

ビューを再作成します。

(継承元 CollectionView)
Remove(Object)

コレクションまたはビューから、指定された項目参照を削除します。

RemoveAt(Int32)

コレクションまたはビューの指定されたインデックス位置にある項目を削除します。

SetCurrent(Object, Int32)

指定された項目およびインデックスを CurrentItem プロパティおよび CurrentPosition プロパティの値として設定します。

(継承元 CollectionView)
SetCurrent(Object, Int32, Int32)

指定された項目およびインデックスを CurrentItem プロパティおよび CurrentPosition プロパティの値として設定します。 このメソッドは、派生クラスのコンストラクターから呼び出すことができます。

(継承元 CollectionView)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
VerifyAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。

(継承元 DispatcherObject)

イベント

CollectionChanged

ビューが変化すると発生します。

(継承元 CollectionView)
CurrentChanged

CurrentItem が変更された後に発生します。

(継承元 CollectionView)
CurrentChanging

CurrentItem が変更されているときに発生します。

(継承元 CollectionView)
PropertyChanged

プロパティ値が変更されたときに発生します。

(継承元 CollectionView)

明示的なインターフェイスの実装

ICollection.IsSynchronized

このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。

ICollection.SyncRoot

このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。

IEditableCollectionView.AddNew()

新しい項目をコレクションに追加します。

IEditableCollectionView.CanAddNew

新しい項目をコレクションに追加できるかどうかを示す値を取得します。

IEditableCollectionView.CanCancelEdit

コレクション ビューが保留中の変更を破棄して、編集されたオブジェクトの元の値を復元できるかどうかを示す値を取得します。

IEditableCollectionView.CancelEdit()

編集トランザクションを終了し、可能な場合は、項目の元の値を復元します。

IEditableCollectionView.CancelNew()

追加トランザクションを終了し、保留中の新しい項目を破棄します。

IEditableCollectionView.CanRemove

コレクションから項目を削除できるかどうかを示す値を取得します。

IEditableCollectionView.CommitEdit()

編集トランザクションを終了し、保留中の変更を保存します。

IEditableCollectionView.CommitNew()

追加トランザクションを終了し、保留中の新しい項目を保存します。

IEditableCollectionView.CurrentAddItem

現在の追加トランザクション処理中に追加される項目を取得します。

IEditableCollectionView.CurrentEditItem

編集されているコレクション内の項目を取得します。

IEditableCollectionView.EditItem(Object)

指定した項目の編集トランザクションを開始します。

IEditableCollectionView.IsAddingNew

追加トランザクションが実行中かどうかを示す値を取得します。

IEditableCollectionView.IsEditingItem

編集トランザクションが実行中かどうかを示す値を取得します。

IEditableCollectionView.NewItemPlaceholderPosition

コレクション ビューにある新しい項目のプレースホルダーの位置を取得または設定します。

IEditableCollectionView.Remove(Object)

指定した項目をコレクションから削除します。

IEditableCollectionView.RemoveAt(Int32)

コレクション内の指定した位置にある項目を削除します。

IEditableCollectionViewAddNewItem.AddNewItem(Object)

指定したオブジェクトをコレクションに追加します。

IEditableCollectionViewAddNewItem.CanAddNewItem

指定したオブジェクトをコレクションに追加できるかどうかを示す値を取得します。

IEnumerable.GetEnumerator()

ビュー内の項目を列挙するために使用できる IEnumerator オブジェクトを返します。

(継承元 CollectionView)
IItemProperties.ItemProperties

コレクション内の項目で使用できるプロパティに関する情報を格納するコレクションを取得します。

IList.IsFixedSize

このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。

IList.IsReadOnly

このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。

INotifyCollectionChanged.CollectionChanged

ビューが変化すると発生します。

(継承元 CollectionView)
INotifyPropertyChanged.PropertyChanged

プロパティ値が変更するときに発生します。

(継承元 CollectionView)
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)

中央のイベント マネージャーからイベントを受信します。

拡張メソッド

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。

AsParallel(IEnumerable)

クエリの並列化を有効にします。

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。

適用対象

こちらもご覧ください