ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource Property

定義

ItemsControl のコンテンツの生成に使用するコレクションを取得または設定します。Gets or sets a collection used to generate the content of the ItemsControl.

public:
 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };
[System.ComponentModel.Bindable(true)]
public System.Collections.IEnumerable ItemsSource { get; set; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

プロパティ値

ItemsControl のコンテンツの生成に使用されるコレクション。A collection that is used to generate the content of the ItemsControl. 既定値は、null です。The default is null.

注釈

コンテンツ モデル: このプロパティが項目を追加するため、ItemsControlします。Content Model: This property may be used to add items to an ItemsControl.

一般的なシナリオは、ItemsControlなど、 ListBoxListView、またはTreeViewデータ コレクションを表示するか、バインド、ItemsControlをコレクション オブジェクト。A common scenario is to use an ItemsControl such as a ListBox, ListView, or TreeView to display a data collection, or to bind an ItemsControl to a collection object. バインドする、ItemsControlをコレクション オブジェクトを使用して、ItemsSourceプロパティ。To bind an ItemsControl to a collection object, use the ItemsSource property. なお、ItemsSourceプロパティがサポートされますOneWayデフォルトをバインドします。Note that the ItemsSource property supports OneWay binding by default.

ときに、ItemsSourceプロパティが設定されて、Items読み取り専用および固定サイズ コレクションが表示されます。When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

ときにItemsSourceプロパティを設定して、使用中はnullコレクションを削除し、復元の使用状況をItems、空になるItemCollectionします。When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. ときにItemsSourceはこのプロパティの値には、使用中でないnullに設定してnullも何も起こりません。When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

注意

ほとんどの場合は、独自のコレクションを実装する必要はありません。In most cases you do not need to implement your own collections. 代わりに、ObservableCollection<T>またはその他の既存のコレクション。Instead, consider using ObservableCollection<T> or other existing collections. 詳細については、「コレクション オブジェクト使用としてバインド ソース」を参照してくださいバインディング ソースの概要します。For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

XAML 属性の使用方法XAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

XAML 値XAML Values

bindingDeclarationbindingDeclaration
ABinding宣言します。A Binding declaration. 参照してくださいバインディング マークアップ拡張機能詳細についてはします。See Binding Markup Extension for more information.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field ItemsSourceProperty
メタデータのプロパティを設定するには trueMetadata properties set to true なしNone

適用対象