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¶
→ Faute de frappe ou propriété non publique. → Ajoutezx: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…) :
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 etDataTemplate, compilez, corrigez les chemins signalés. - En C#,
new Binding("Nom")reste un binding par réflexion ; préférezCompiledBinding.Create(...).