ItemsControl.ItemsSource Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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 ItemsControlListBoxcomo , 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 null
y 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 |