Converting Binding Values

Search…
Negating Values
Often you will need to negate a value that you're binding to. A frequent use for this is to show/hide a control or to enable/disable it. You can negate a binding value by prepending a "bang" operator: !.
For example you might want to show one control when another control is disabled.
1
<StackPanel>
2
  <TextBox Name="input" IsEnabled="{Binding AllowInput}"/>
3
  <TextBlock IsVisible="{Binding !AllowInput}">Sorry, no can do!</TextBlock>
4
</StackPanel>
Copied!
Negation also works when binding to non-boolean values. First of all, the value is converted to a boolean using Convert.ToBoolean and the result from this is negated. Because the integer value 0 is considered false and all other integer values are considered true, you can use this to show a message when a collection is empty:
1
<Panel>
2
  <ListBox Items="{Binding Items}"/>
3
  <TextBlock IsVisible="{Binding !Items.Count}">No results found</TextBlock>
4
</Panel>
Copied!
A "double-bang" can be used to convert a non-boolean value to a boolean value. For example to hide a control when a collection is empty:
1
<Panel>
2
  <ListBox Items="{Binding Items}" IsVisible="{Binding !!Items.Count}"/>
3
</Panel>
Copied!
Binding Converters
For more advanced conversions, Avalonia supports IValueConverter the same as other XAML frameworks.
Note: The IValueConverter interface is not available in .NET standard 2.0 so we ship our own, in the Avalonia.Data.Converters namespace.
Usage is identical to other XAML frameworks:
1
<Window xmlns="https://github.com/avaloniaui"
2
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
3
        xmlns:local="clr-namespace:ExampleApp;assembly=ExampleApp">
4
​
5
  <Window.Resources>
6
    <local:MyConverter x:Key="myConverter"/>
7
  </Window.Resources>
8
​
9
  <TextBlock Text="{Binding Value, Converter={StaticResource myConverter}}"/>
10
</Window>
Copied!
Built-in Converters
Avalonia supplies a number of built-in value converters for common scenarios:
Converter
Description
StringConverters.IsNullOrEmpty
Returns true if the input string is null or empty
StringConverters.IsNotNullOrEmpty
Returns false if the input string is null or empty
ObjectConverters.IsNull
Returns true if the input is null
ObjectConverters.IsNotNull
Returns false if the input is null
BoolConverters.And
A multi-value converter that returns true if all inputs are true.
Examples
Hiding a TextBlock if the bound text is null or empty:
1
<TextBlock Text="{Binding MyText}"
2
           IsVisible="{Binding MyText, Converter={x:Static StringConverters.IsNotNullOrEmpty}}"/>
Copied!
Hiding a ContentControl if the bound content is null or empty:
1
<ContentControl Content="{Binding MyContent}"
2
                IsVisible="{Binding MyContent, Converter={x:Static ObjectConverters.IsNotNull}}"/>
Copied!
Binding to Controls
Binding to Commands
Last modified 1mo ago
Export as PDF
Copy link
Edit on GitHub
Contents