ItemsControl.ItemsSource プロパティ

定義

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; }
[<System.ComponentModel.Bindable(true)>]
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

プロパティ値

ItemsControl のコンテンツ生成に使用されるコレクション。 既定値は、null です。

属性

注釈

コンテンツ モデル: このプロパティは、 に項目 ItemsControlを追加するために使用できます。

一般的なシナリオは、 などの TreeViewListBoxListViewItemsControl使用してデータ コレクションを表示したり、 をコレクション オブジェクトにバインドItemsControlしたりすることです。 を ItemsControl コレクション オブジェクトにバインドするには、 プロパティを ItemsSource 使用します。 プロパティは ItemsSource 既定でバインディングを OneWay サポートしています。

プロパティを ItemsSource 設定すると、 Items コレクションは読み取り専用および固定サイズになります。

が使用されている場合 ItemsSource 、 プロパティを に設定すると null 、コレクションが削除され、使用法が に Items復元されます。これは空 ItemCollectionの になります。 が使用されていない場合 ItemsSource 、このプロパティの値は であり null、 を に null 設定しても効果はありません。

注意

ほとんどの場合、独自のコレクションを実装する必要はありません。 代わりに、または他の既存のコレクションを使用 ObservableCollection<T> することを検討してください。 詳細については、「バインディング ソースの 概要」の「バインディング ソースとして使用されるコレクション オブジェクト」を参照してください。

XAML 属性の使用方法

<object ItemsSource="bindingDeclaration"/>

XAML 値

bindingDeclarationBinding宣言。 詳細については、「 バインディング マークアップ拡張機能 」を参照してください。

依存プロパティ情報

識別子フィールド ItemsSourceProperty
に設定されたメタデータ プロパティ true なし

適用対象