CollectionViewSource Classe

Définition

public ref class CollectionViewSource sealed : DependencyObject

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CollectionViewSource final : DependencyObject

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CollectionViewSource : DependencyObject

Public NotInheritable Class CollectionViewSource
Inherits DependencyObject

<CollectionViewSource .../>

Héritage

Object Platform::Object IInspectable DependencyObject CollectionViewSource

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

L’application WinUI 3 Gallery comprend des exemples interactifs de la plupart des contrôles et des fonctionnalités WinUI 3. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

L’exemple de code suivant montre comment lier un contrôle ListBox aux résultats d’une requête LINQ de regroupement. Dans cet exemple, une collection d’équipes est regroupée par ville et affichée avec le nom de la ville comme en-têtes de groupe. Pour obtenir la liste complète du code, consultez l’exemple de liaison de données XAML.

<Grid>

  <Grid.Resources>
    <CollectionViewSource x:Name="groupInfoCVS" IsSourceGrouped="true"/>
  </Grid.Resources>

  <ListBox x:Name="lbGroupInfoCVS" 
    ItemsSource="{Binding Source={StaticResource groupInfoCVS}}">

    <ListBox.GroupStyle>
      <GroupStyle>
        <GroupStyle.HeaderTemplate>
          <DataTemplate>

            <TextBlock Text="{Binding Key}"/>

          </DataTemplate>
        </GroupStyle.HeaderTemplate>
      </GroupStyle>
    </ListBox.GroupStyle>

    <ListBox.ItemTemplate>
      <DataTemplate>

        <Border Background="{Binding Color}" 
          Width="200" CornerRadius="10" HorizontalAlignment="Left">

          <TextBlock Text="{Binding Name}" 
            Style="{StaticResource DescriptionTextStyle}" 
            HorizontalAlignment="Center" FontWeight="Bold"/>

        </Border>
      </DataTemplate>
    </ListBox.ItemTemplate>

  </ListBox>

</Grid>

Teams teams = new Teams();
var result = 
    from t in teams 
    group t by t.City into g 
    orderby g.Key 
    select g;
groupInfoCVS.Source = result;

Remarques

Utilisez CollectionViewSource lorsque vous souhaitez lier des contrôles de liste à des regroupements, mais que vous souhaitez afficher ces regroupements dans des groupes et conserver un élément actif indépendant du contrôle de liste. Cela est particulièrement utile lorsque vous souhaitez lier plusieurs contrôles à la même collection et que vous souhaitez que l’élément actuel dans un contrôle modifie l’élément actif dans les autres contrôles liés. Vous définissez généralement une collectionViewSource en tant que ressource XAML et vous la liez à l’aide de l’extension de balisage {StaticResource}. Vous pouvez ensuite définir sa propriété Source dans code-behind sur un type de collection pris en charge.

Tous les contrôles que vous liez au même Élément CollectionViewSource auront toujours le même élément actif. Vous pouvez accéder à l’élément actif par programmation via la propriété ICollectionView.CurrentItem de la valeur de la propriété CollectionViewSource.View .

Si les éléments de la collection sont eux-mêmes des collections, ou s’il s’agit d’objets qui contiennent des collections, vous pouvez afficher les collections en tant que groupes au sein de la collection plus grande. Pour ce faire, affectez à la propriété IsSourceGrouped la valeur true. Si les éléments contiennent des collections mais ne sont pas des collections elles-mêmes, vous devez également définir la propriété ItemsPath sur le nom de la propriété de collection.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• Binding
• Présentation détaillée de la liaison de données
• Exemple de liaison de données XAML