ItemsControl.ItemsSource Propiedad

Definición

Obtiene o establece una colección utilizada para se usa para generar el contenido de 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

Valor de propiedad

IEnumerable

Colección que se usa para generar el contenido de ItemsControl. De manera predeterminada, es null.

Atributos

Comentarios

Modelo de contenido: Esta propiedad se puede usar para agregar elementos a .ItemsControl

Un escenario común es usar un ItemsControl ListBoxcomo , ListViewo TreeView para mostrar una colección de datos, o para enlazar un ItemsControl objeto a un objeto de colección. Para enlazar un objeto ItemsControl a un objeto de colección, use la ItemsSource propiedad . Tenga en cuenta que la propiedad admite OneWay el ItemsSource enlace de forma predeterminada.

Cuando se establece la ItemsSource propiedad , la Items colección se convierte en de solo lectura y tamaño fijo.

Cuando ItemsSource está en uso, al establecer la propiedad para null quitar la colección y se restaura el uso en Items, que será un vacío ItemCollection. Cuando ItemsSource no está en uso, el valor de esta propiedad es nully establecerlo null en no tiene ningún efecto.

Nota

En la mayoría de los casos, no es necesario implementar sus propias colecciones. En su lugar, considere la posibilidad de usar ObservableCollection<T> u otras colecciones existentes. Para obtener más información, vea "Objetos de colección usados como origen de enlace" en Información general sobre orígenes de enlace.

Uso de atributos XAML

<object ItemsSource="bindingDeclaration"/>  

Valores XAML

bindingDeclaration
Una Binding declaración. Consulte Extensión de marcado de enlace para obtener más información.

Información sobre propiedades de dependencia

Campo identificador ItemsSourceProperty
Propiedades de metadatos establecidas en true None

Se aplica a