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);
}
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
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}" />
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 :