Aller au contenu

Compiled bindings v12

En Avalonia 12, {Binding} est vérifié à la compilation. Il suffit d'indiquer le type avec x:DataType.

Pourquoi

Compilé (défaut v12) Réflexion
Faute de frappe dans le chemin erreur de compilation binding silencieusement vide
Performance meilleure réflexion à l'exécution
Trimming / Native AOT compatible problématique
Typage requis (x:DataType) libre
flowchart LR
  X["{Binding Titr}<br/>(faute de frappe)"] --> C{"Compilation"}
  C -- "compiled binding<br/>(défaut v12)" --> E["❌ erreur de build :<br/>Titr introuvable sur MainViewModel"]
  C -- "reflection binding" --> R["✔ compile…"] --> S["… puis texte vide à l'exécution,<br/>sans erreur visible"]

x:DataType

<Window xmlns:vm="using:MonApp.ViewModels"
        x:DataType="vm:MainViewModel">
  <TextBlock Text="{Binding Titre}" />
</Window>

Dans un DataTemplate

Chaque template déclare son propre type :

<ListBox ItemsSource="{Binding Clients}">
  <ListBox.ItemTemplate>
    <DataTemplate x:DataType="m:Client">
      <TextBlock Text="{Binding Nom}" />
    </DataTemplate>
  </ListBox.ItemTemplate>
</ListBox>

Changer de type en cours de route

<StackPanel DataContext="{Binding Client}" x:DataType="m:Client">
  <TextBlock Text="{Binding Nom}" />
</StackPanel>

Types primitifs

<DataTemplate x:DataType="x:String">
  <TextBlock Text="{Binding}" />
</DataTemplate>

<DataTemplate x:DataType="sys:Int32" xmlns:sys="using:System">
  <TextBlock Text="{Binding}" />
</DataTemplate>

Erreurs courantes

Unable to resolve property or method of name 'Titr' on type 'MainViewModel'.
→ Faute de frappe ou propriété non publique.

Cannot parse a compiled binding without an explicit x:DataType directive.
→ Ajoutez x:DataType sur la vue ou le template.

Remonter vers un parent avec un cast

<Button Command="{Binding $parent[ItemsControl].((vm:MainViewModel)DataContext).OuvrirCommand}"
        CommandParameter="{Binding}" />

Cas où la réflexion est utile

Données de type inconnu à la compilation (object, dynamic, dictionnaires…) :

<TextBlock Text="{ReflectionBinding Proprietes[Nom]}" />

Désactiver localement :

<StackPanel x:CompileBindings="False">
  <TextBlock Text="{Binding QuelqueChose}" />   <!-- par réflexion -->
</StackPanel>

Désactiver pour tout le projet (déconseillé) :

MonApp.csproj
<PropertyGroup>
  <AvaloniaUseCompiledBindingsByDefault>false</AvaloniaUseCompiledBindingsByDefault>
</PropertyGroup>

Migration depuis Avalonia 11

  • Les projets créés avec les templates v11 avaient déjà ce comportement : rien à faire.
  • Sinon : ajoutez x:DataType à chaque vue et DataTemplate, compilez, corrigez les chemins signalés.
  • En C#, new Binding("Nom") reste un binding par réflexion ; préférez CompiledBinding.Create(...).
// v11
var b = new Binding(nameof(Item.Valeur));
// v12
var b = CompiledBinding.Create((Item item) => item.Valeur);