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 puede utilizarse para agregar elementos a un ItemsControl.Content Model: This property may be used to add items to an ItemsControl.

Un escenario común es usar un ItemsControl como un ListBox, ListView, o TreeView para mostrar una recolecció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 un ItemsControl a un objeto de colección, utilice el ItemsSource propiedad.To bind an ItemsControl to a collection object, use the ItemsSource property. Tenga en cuenta que el ItemsSource admite la propiedad OneWay enlazar de forma predeterminada.Note that the ItemsSource property supports OneWay binding by default.

Cuando el ItemsSource propiedad está establecida, el Items se realiza la colección 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, establecer la propiedad en null quita la colección y restaura el uso a Items, que estará vacío ItemCollection.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 es no esté en uso, el valor de esta propiedad es nully si se establece 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 recopilaciones.In most cases you do not need to implement your own collections. En su lugar, considere el uso de ObservableCollection<T> u otras colecciones existentes.Instead, consider using ObservableCollection<T> or other existing collections. Para obtener más información, vea la "colección de objetos utilizado como origen de enlace" en Binding Sources Overview.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
Un Binding declaración.A Binding declaration. Consulte extensión de marcado de enlace 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
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a