ItemsControl.ItemsSource プロパティ


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

 property System::Collections::IEnumerable ^ ItemsSource { System::Collections::IEnumerable ^ get(); void set(System::Collections::IEnumerable ^ value); };
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.

一般的なシナリオでは、ListBoxListViewTreeView などの ItemsControl を使用してデータコレクションを表示したり、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

Binding の宣言です。A Binding declaration. 詳細については、「バインドマークアップ拡張機能」を参照してください。See Binding Markup Extension for more information.

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

識別子フィールドIdentifier field ItemsSourceProperty
メタデータプロパティが true に設定されるMetadata properties set to true なしNone