ItemsControl.ItemsSource Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera lub ustawia kolekcję używaną do generowania zawartości elementu 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

Wartość właściwości

IEnumerable

Kolekcja używana do generowania zawartości elementu ItemsControl. Wartość domyślna to null.

Atrybuty

BindableAttribute

Uwagi

Model zawartości: Ta właściwość może służyć do dodawania elementów do obiektu ItemsControl.

Typowym scenariuszem jest użycie obiektu ItemsControl takiego jak ListBox, ListViewlub TreeView w celu wyświetlenia kolekcji danych lub powiązania ItemsControl obiektu kolekcji. Aby powiązać obiekt ItemsControl z obiektem kolekcji, użyj ItemsSource właściwości . Należy pamiętać, że ItemsSource właściwość domyślnie obsługuje OneWay powiązanie.

Po ustawieniu ItemsSource Items właściwości kolekcja jest ustawiana tylko do odczytu i o stałym rozmiarze.

Gdy ItemsSource jest używana, ustawienie właściwości w celu null usunięcia kolekcji i przywrócenie użycia na Itemswartość , która będzie pustą ItemCollectionwartością . Jeśli ItemsSource właściwość nie jest używana, wartość tej właściwości to null, a ustawienie jej na null wartość nie ma żadnego wpływu.

Uwaga

W większości przypadków nie trzeba implementować własnych kolekcji. Zamiast tego rozważ użycie ObservableCollection<T> lub inne istniejące kolekcje. Aby uzyskać więcej informacji, zobacz sekcję "Obiekty kolekcji używane jako źródło powiązania" w temacie Binding Sources Overview (Omówienie źródeł powiązań).

Użycie atrybutu języka XAML

<object ItemsSource="bindingDeclaration"/>  

Wartości XAML

bindingDeclaration
Binding Deklaracja. Aby uzyskać więcej informacji , zobacz Binding Markup Extension (Rozszerzenie znaczników powiązania ).

Informacje dotyczące właściwości zależności

Pole identyfikatora	ItemsSourceProperty
Właściwości metadanych ustawione na true	Brak