ItemsControl.ItemsSource Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets an object source used to generate the content of the ItemsControl.
public:
property Platform::Object ^ ItemsSource { Platform::Object ^ get(); void set(Platform::Object ^ value); };
IInspectable ItemsSource();
void ItemsSource(IInspectable value);
public object ItemsSource { get; set; }
var object = itemsControl.itemsSource;
itemsControl.itemsSource = object;
Public Property ItemsSource As Object
<itemsControl ItemsSource="bindingDeclaration"/>
-or-
<itemsControl ItemsSource="resourceReferenceToSource"/>
Property Value
The object that is used to generate the content of the ItemsControl. The default is null
.
Remarks
The type of the object that you set the ItemsSource property to must implement one of these interfaces.
.NET | C++/WinRT | C++/CX |
---|---|---|
IEnumerable<Object> | IVector<IInspectable> | IIterable<IInspectable> |
IEnumerable | IBindableObservableVector | IBindableIterable |
The ItemsControl can provide better performance if the ItemsSource property value also implements a random-access list interface.
The ItemsControl can raise collection-changed notification events if the ItemsSource property value also implements a collection-changed notification interface.
.NET | C++/WinRT | C++/CX |
---|---|---|
Managed desktop C#/.NET Core apps System.Collections.Specialized.INotifyCollectionChanged Universal Windows Platform (UWP) apps |
IObservableVector<IInspectable> | IObservableVector<IInspectable> |
For .NET, in order for the collection-changed events to be handled, the ItemsSource property must also implement the non-generic IList interface.