Skip to content

Upgrading to Avalonia v11

Jump to bottom
Damian edited this page Dec 8, 2022 · 9 revisions

Coming Soon!

This page will assist you with upgrading your application to the latest Avalonia v11, which is currently in preview.

DataTemplates and DataTypes

This is a breaking change that affects your Views.

Developers must define the DataType property of the DataTemplate and ItemTemplate elements.

Tips To Avoid Issues

Use CompileBindings

When using Compiled Bindings in your XAML, not only will your applications perform better, but it will also allow the compiler will throw an error immediately so that you do not get any surprises at runtime.

To get started using Compiled Bindings you must add a few properties to your main control/window element.

  1. xmlns:vm="using:NAMESPACE.OF.VIEWMODEL"
  2. x:CompileBindings="True"
  3. x:DataType="vm:YOURVIEWMODEL"

For more information, see the official documentation of Compiled Bindings to better assist your project's needs.

Sample:

<UserControl xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:vm="using:SampleMvvmApp.ViewModels"
             xmlns:system="clr-namespace:System;assembly=mscorlib"
             x:Class="SampleMvvmApp.Views.DashboardView"
             x:CompileBindings="True"
             x:DataType="vm:DashboardViewModel">
Clone this wiki locally