ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource ItemsControl.ItemsSource Property

Definición

Obtiene o establece una recolección que se utiliza para generar el contenido de ItemsControl.Gets or sets a collection used to generate the content of the 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; }
member this.ItemsSource : System.Collections.IEnumerable with get, set
Public Property ItemsSource As IEnumerable

Valor de propiedad

La recolección que se utiliza para generar el contenido de ItemsControl.A collection that is used to generate the content of the ItemsControl. De manera predeterminada, es null.The default is null.

Comentarios

Modelo de contenido: Esta propiedad se puede utilizar para agregar elementos a un ItemsControl.Content Model: This property may be used to add items to an ItemsControl.

Un escenario común es ItemsControl usar un ListBox ListView,, o TreeView para mostrar una colección de datos, o para enlazar un ItemsControl a un objeto de colección.A common scenario is to use an ItemsControl such as a ListBox, ListView, or TreeView to display a data collection, or to bind an ItemsControl to a collection object. Para enlazar ItemsControl un a un objeto de colección, ItemsSource use la propiedad.To bind an ItemsControl to a collection object, use the ItemsSource property. Tenga en cuenta ItemsSource que la OneWay propiedad admite el enlace de forma predeterminada.Note that the ItemsSource property supports OneWay binding by default.

Cuando se ItemsSource establece la propiedad, la Items colección se convierte en de solo lectura y de tamaño fijo.When the ItemsSource property is set, the Items collection is made read-only and fixed-size.

Cuando ItemsSource está en uso, al establecer la propiedad null en se quita la colección y se restaura el Itemsuso de, que será un ItemCollectionvacío.When ItemsSource is in use, setting the property to null removes the collection and restores usage to Items, which will be an empty ItemCollection. Cuando ItemsSource no está en uso, el valor de esta propiedad es nully establecerlo en null no tiene ningún efecto.When ItemsSource is not in use, the value of this property is null, and setting it to null has no effect.

Nota

En la mayoría de los casos no es necesario implementar sus propias colecciones.In most cases you do not need to implement your own collections. En su lugar, considere ObservableCollection<T> el uso de u otras colecciones existentes.Instead, consider using ObservableCollection<T> or other existing collections. Para obtener más información, vea "objetos de colección usados como origen de enlace" en información general sobre orígenes de enlaces.For more information, see the "Collection Objects Used as Binding Source" in Binding Sources Overview.

Uso de atributos XAMLXAML Attribute Usage

<object ItemsSource="bindingDeclaration"/>  

Valores XAMLXAML Values

bindingDeclarationbindingDeclaration
Una Binding declaración.A Binding declaration. Consulte enlace de la extensión de marcado para obtener más información.See Binding Markup Extension for more information.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ItemsSourceProperty
Propiedades de metadatos establecidas entrueMetadata properties set to true NingunaNone

Se aplica a