The library allows to create IValueConverter
, IMultiValueConverter
, DataTemplateSelector
, and ValidationRule
objects with the most convenient syntax available, ideally, using the lambda expressions.
First create a (static) class and define your converters as static fields (or properties):
internal static class Converters
{
public static readonly IValueConverter VisibleIfTrue =
ValueConverter.Create<bool, Visibility>(e => e.Value ? Visibility.Visible : Visibility.Collapsed);
public static readonly IValueConverter VisibleIfNotNull =
ValueConverter.Create<object, Visibility>(e => e.Value != null ? Visibility.Visible : Visibility.Collapsed);
public static readonly IValueConverter ToUpperCase =
ValueConverter.Create<string, string>(e => e.Value.ToUpper());
}
You're done! Just reference the converters with the x:Static
expressions from your XAML files (assuming that c
is the namespace definition for the Converters
class):
<Button Visibility="{Binding model.IsAvailable, Converter={x:Static c:Converters.VisibleIfTrue}}" />
<TextBlock Text="{Binding model.Heading, Converter={x:Static c:Converters.ToUpperCase}}" />
- strongly-typed converters
- resource declaration not needed, just use the
x:Static
expressions - separate class for each converter not needed anymore
- no redundant declarations: if you do not need the
ConvertBack
method, don't define it; otherwise, just put the second lambda expression - full support for the remaining parameters of the
Convert
andConvertBack
methods: theculture
and theparameter
(also strongly-typed) are accessible as well - if the conversion fails due to unexpected value types the optional error strategy can be specified
The library also allows to create DataTemplateSelector
objects in the same convenient way as value converters. In order to define a selector simply write a static field (or property) similar to this snippet:
internal static class TemplateSelector
{
public static DataTemplateSelector AlternatingText =
LambdaConverters.TemplateSelector.Create<int>(
e => e.Item % 2 == 0
? (DataTemplate) ((FrameworkElement) e.Container)?.FindResource("BlackWhite")
: (DataTemplate) ((FrameworkElement) e.Container)?.FindResource("WhiteBlack"));
}
Use your Lambda DataTemplateSelectors by referencing it with the x:Static
markup extention (assuming that s
is the namespace definition for the TemplateSelector
class):
<UserControl.Resources>
<DataTemplate x:Key="BlackWhite">
<TextBlock Text="{Binding}" Foreground="Black" Background="White" />
</DataTemplate>
<DataTemplate x:Key="WhiteBlack">
<TextBlock Text="{Binding}" Foreground="White" Background="Black" />
</DataTemplate>
</UserControl.Resources>
<DockPanel>
<ListBox ItemsSource="{Binding IntNumbers}"
ItemTemplateSelector="{x:Static s:TemplateSelector.AlternatingText}">
</ListBox>
</DockPanel>
Tada! All even numbers from IntNumbers
are displayed with black font and white background and the odd numbers get the inverse font and background colors.
- strongly-typed Selectors
- resource declaration not needed, just use the
x:Static
expressions - separate class for each selector not needed anymore
- full support for the remaining parameter
container
. For example, if you need to grab aDataTemplate
from where the selector is use (see the example above).
Furthermore, you'll get Lambda ValidationRules on top. By now you know "the drill". First, define a ValidationRule
object like this:
public static class Rule
{
public static ValidationRule IsNumericString =
LambdaConverters.Validator.Create<string>(
e => e.Value.All(char.IsDigit)
? ValidationResult.ValidResult
: new ValidationResult(false, "Text has non-digit characters!"));
}
And then reference your new rule in vour View
(assuming that r
is the namespace definition for the Rule
class):
<TextBox>
<TextBox.Text>
<Binding Path="Text" UpdateSourceTrigger="PropertyChanged">
<Binding.ValidationRules>
<x:Static Member="r:Rule.IsNumericString"/>
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
</TextBox>
Now, you made sure that only strings which consists of digits are passed to your ViewModel
.
- strongly-typed rules
- resource declaration not needed, just use the
x:Static
expressions - separate class for each rule not needed anymore
- full support for the remaining parameter
culture
Use the NuGet package manager to install the package.
💡 ReSharper users: use the Extension Manager to install the external annotations for the library.
The library currently supports the WPF only.
Please feel free to report them.