Aller au contenu

Collections

Une liste que la vue suit automatiquement : ObservableCollection<T>.

ObservableCollection

public partial class TachesViewModel : ObservableObject
{
    public ObservableCollection<Tache> Taches { get; } = new();

    [ObservableProperty]
    public partial Tache? Selection { get; set; }

    [RelayCommand]
    private void Ajouter() => Taches.Add(new Tache { Titre = "Nouvelle tâche" });

    [RelayCommand]
    private void Supprimer(Tache tache) => Taches.Remove(tache);
}
<ListBox ItemsSource="{Binding Taches}" SelectedItem="{Binding Selection}" />
Aperçu · Add / Remove mettent la vue à jour
Tâche 1Tâche 2
flowchart LR
  subgraph OC["ObservableCollection"]
    A1["Add / Remove"] --> E["CollectionChanged"] --> V1["ListBox ajoute / retire la ligne ✔"]
  end
  subgraph L["List"]
    A2["Add / Remove"] --> X["aucun événement"] --> V2["ListBox ne bouge pas ✘"]
  end

List ne suffit pas

Avec une List<T>, ajouter ou retirer un élément ne met pas à jour la vue.

Modifier les éléments eux-mêmes

ObservableCollection notifie les ajouts/suppressions, pas les changements dans un élément. L'élément doit être observable :

Changement Qui prévient la vue ?
Taches.Add(t) / Remove(t) ObservableCollection (CollectionChanged)
t.EstFaite = true Tache elle-même (PropertyChanged)
Taches = nouvelleListe le ViewModel (PropertyChanged("Taches"))
public partial class Tache : ObservableObject
{
    [ObservableProperty] public partial string Titre { get; set; } = "";
    [ObservableProperty] public partial bool EstFaite { get; set; }
}

Remplacer toute la liste

// Option 1 : vider puis remplir
Taches.Clear();
foreach (var t in await _api.GetTachesAsync()) Taches.Add(t);

// Option 2 : propriété observable remplacée d'un bloc
[ObservableProperty]
public partial IReadOnlyList<Tache> Resultats { get; set; } = [];

Resultats = await _api.RechercherAsync(texte);

Filtrer

private readonly List<Contact> _tous = new();
public ObservableCollection<Contact> Visibles { get; } = new();

[ObservableProperty]
public partial string Filtre { get; set; } = "";

partial void OnFiltreChanged(string value)
{
    Visibles.Clear();
    foreach (var c in _tous.Where(c => c.Nom.Contains(value, StringComparison.CurrentCultureIgnoreCase)))
        Visibles.Add(c);
}
<TextBox Text="{Binding Filtre}" PlaceholderText="Filtrer…" />
<ListBox ItemsSource="{Binding Visibles}" />
Aperçu · tapez « a »
Ada LovelaceAlan TuringGrace HopperLinus TorvaldsMargaret Hamilton

_tous garde toujours la liste complète ; Visibles (liée à la vue) n'en contient qu'une partie.

Trier

[RelayCommand]
private void TrierParNom()
{
    var tries = Visibles.OrderBy(c => c.Nom).ToList();
    Visibles.Clear();
    foreach (var c in tries) Visibles.Add(c);
}

Compteurs et totaux

public TachesViewModel()
{
    Taches.CollectionChanged += (_, _) => OnPropertyChanged(nameof(Restantes));
}

public int Restantes => Taches.Count(t => !t.EstFaite);
<TextBlock Text="{Binding Restantes, StringFormat='{}{0} tâche(s) restante(s)'}" />
<TextBlock Text="{Binding Taches.Count}" />

Sélection multiple

public ObservableCollection<Fichier> Selection { get; } = new();

[RelayCommand]
private void SupprimerSelection()
{
    foreach (var f in Selection.ToList()) Fichiers.Remove(f);
}
<ListBox ItemsSource="{Binding Fichiers}" SelectionMode="Multiple" SelectedItems="{Binding Selection}" />

Grouper

public record Groupe(string Lettre, IReadOnlyList<Contact> Contacts);

Groupes = contacts
    .GroupBy(c => c.Nom[..1].ToUpper())
    .OrderBy(g => g.Key)
    .Select(g => new Groupe(g.Key, g.ToList()))
    .ToList();
<ItemsControl ItemsSource="{Binding Groupes}">
  <ItemsControl.ItemTemplate>
    <DataTemplate x:DataType="vm:Groupe">
      <StackPanel>
        <TextBlock Text="{Binding Lettre}" FontWeight="Bold" Margin="0,12,0,4" />
        <ItemsControl ItemsSource="{Binding Contacts}">
          <ItemsControl.ItemTemplate>
            <DataTemplate x:DataType="m:Contact">
              <TextBlock Text="{Binding Nom}" Margin="12,2" />
            </DataTemplate>
          </ItemsControl.ItemTemplate>
        </ItemsControl>
      </StackPanel>
    </DataTemplate>
  </ItemsControl.ItemTemplate>
</ItemsControl>

Depuis un autre thread

Modifiez une collection liée uniquement sur le thread UI :

var donnees = await Task.Run(ChargerDepuisDisque);   // travail en arrière-plan
foreach (var d in donnees) Elements.Add(d);          // de retour sur le thread UI