ItemsRepeater.ItemsSource Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Obtiene o establece un origen de objeto utilizado para generar el contenido de ItemsRepeater.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en el SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para Windows).

public:
 property Platform::Object ^ ItemsSource { Platform::Object ^ get(); void set(Platform::Object ^ value); };

/// [get: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [set: Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
IInspectable ItemsSource();

void ItemsSource(IInspectable value);

public object ItemsSource { [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)] get; [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)] set; }

Public Property ItemsSource As Object

Valor de propiedad

Object

Platform::Object

IInspectable

Objeto que se usa para generar el contenido de ItemsRepeater. El valor predeterminado es NULL.

Comentarios

Usa la propiedad ItemsSource para especificar la colección que se va a emplear para generar el contenido de los elementos. Puedes establecer la propiedad ItemsSource en cualquier tipo que implemente IEnumerable. Las interfaces de colección adicionales que implemente el origen de datos determinarán qué funcionalidades están a disposición de ItemsRepeater para interactuar con los datos.

En esta lista se muestran las interfaces disponibles y cuándo se debe considerar la posibilidad de usarlas.

• Ienumerable< T> (.NET) / IIterable<T>

  • Puede usarse para conjuntos de datos pequeños y estáticos.

    Como mínimo, el origen de datos debe implementar la interfaz IEnumerable/IIterable. Si esto es todo lo que admite, el control iterará a través de todo el contenido una vez para crear una copia que pueda usar con el fin de acceder a los elementos a través de un valor de índice.

• IReadonlyList< T> (.NET) / IVectorView<T>

  • Puede usarse para conjuntos de datos estáticos y de solo lectura.

    Permite al control acceder a los elementos por índice y evita la copia interna redundante.

• Ilist< T> (.NET) / IVector<T>

  • Puede usarse para conjuntos de datos estáticos.

    Permite al control acceder a los elementos por índice y evita la copia interna redundante.

    Advertencia: Los cambios realizados en la lista/vector sin implementar INotifyCollectionChanged no se reflejarán en la interfaz de usuario.

• System.Collections.Specialized.INotifyCollectionChanged

  • Recomendada para admitir la notificación de cambios.

    Permite al control observar los cambios y reaccionar ante ellos en el origen de datos, así como reflejar dichos cambios en la interfaz de usuario.

• IObservableVector<T>

  • Admite la notificación de cambios.

    Al igual que la interfaz INotifyCollectionChanged, permite al control observar los cambios en el origen de datos y reaccionar ante ellos.

    Advertencia: Windows.Foundation.IObservableVector<no> admite una acción "Mover". Esto puede hacer que la interfaz de usuario de un elemento pierda su estado visual. Por ejemplo, un elemento que actualmente está seleccionado o que tiene el foco donde el movimiento se consigue mediante una acción "Eliminar" seguida de una acción "Agregar" perderá el foco y dejará de estar seleccionado.

    Platform.Collections.Vector<T> usa IObservableVector<T> y tiene esta misma limitación. Si se requiere compatibilidad con una acción "Mover", use la interfaz INotifyCollectionChanged documentada anteriormente. La clase T> ObservableCollection<de .NET usa INotifyCollectionChanged.

• IKeyIndexMapping

  • Cuando se puede asociar un identificador único con cada elemento. Se recomienda al usar "Restablecer" como acción de cambio de la colección.

    Permite al control recuperar de manera muy eficaz la interfaz de usuario existente después de recibir una acción de restablecimiento completo como parte de un evento INotifyCollectionChanged o IObservableVector. Después de recibir un restablecimiento, el control usará el identificador único proporcionado para asociar los datos actuales con los elementos que ya ha creado. Sin la asignación de clave a índice, el control daría por supuesto que tiene que volver a empezar desde cero al crear la interfaz de usuario para los datos.

Las interfaces enumeradas anteriormente, excepto IKeyIndexMapping, proporcionan el mismo comportamiento en ItemsRepeater que en ListView y GridView.

Las interfaces siguientes en una propiedad ItemsSource habilitan funcionalidades especiales en los controles ListView y GridView, pero actualmente no tienen ningún efecto en ItemsRepeater:

• ISupportIncrementalLoading
• IItemsRangeInfo
• ISelectionInfo