绑定值转换器

您现在知道如何使用StringFormat将任何绑定源对象转换为字符串。但是其他数据转换呢？也许您正在使用Slider作为绑定源，但目标是期望整数而不是双精度。或者您可能希望将Switch的值显示为文本，但您想要“是”和“否”而不是“真”和“假”。
这个工作的工具是一个类 - 通常是一个非常小的类 - 非正式地称为值转换器或（有时）绑定转换器。更正式地说，这样的类实现了IValueConverter接口。此接口在Xamarin.Forms命名空间中定义，但它类似于Microsoft基于XAML的环境中提供的接口。
示例：有时应用程序需要根据条目中文本的存在启用或禁用Button。也许按钮标记为保存，条目是文件名。或者按钮标记为发送，条目包含邮件收件人。除非条目包含至少一个文本字符，否则不应启用Button。
有几种方法可以完成这项工作。在后面的章节中，您将看到数据触发器如何执行它（并且还可以对条目中的文本执行有效性检查）。但是对于本章，让我们用一个值转换器来做。
数据绑定目标是Button的IsEnabled属性。该属性属于bool类型。绑定源是Entry的Text属性，或者更确切地说是Text属性的Length属性。该Length属性的类型为int。值转换器需要将int等于0转换为bool为false，将int转换为bool为true。代码很简单。我们只需要将它包装在一个实现IValueConverter的类中。
这是Xamarin.FormsBook.Toolkit库中的该类，包含using指令。 IValueConverter接口由两个方法组成，名为Convert和ConvertBack，具有相同的参数。您可以根据需要使类成为通用类或专用类：

using System;
using System.Globalization;
using Xamarin.Forms;
namespace Xamarin.FormsBook.Toolkit
{
    public class IntToBoolConverter : IValueConverter
    {
        public object Convert(object value, Type targetType, 
                              object parameter, CultureInfo culture)
        {
            return (int)value != 0;
        }
        public object ConvertBack(object value, Type targetType, 
                                  object parameter, CultureInfo culture)
        {
            return (bool)value ? 1 : 0;
        }
    }
}

当您在数据绑定中包含此类时 - 您将很快看到如何执行此操作 - 只要值从源传递到目标，就会调用Convert方法。
Convert的value参数是要转换的数据绑定源的值。您可以使用GetType来确定其类型，或者您可以假设它始终是特定类型。在此示例中，假定value参数的类型为int，因此转换为int不会引发异常。更复杂的值转换器可以执行更多有效性检查。
targetType是数据绑定目标属性的类型。多功能值转换器可以使用此参数来定制不同目标类型的转换。 Convert方法应返回与此targetType匹配的对象或值。这个特殊的Convert方法假设targetType是bool。
参数参数是一个可选的转换参数，您可以将其指定为Binding类的属性。 （您将在第18章“MVVM”中看到一个示例。）
最后，如果您需要执行特定于文化的转换，则最后一个参数是您应该使用的CultureInfo对象。
此特定Convert方法的主体假定value为int，并且该方法返回bool，如果该整数非零，则为true。
ConvertBack方法仅针对TwoWay或OneWayToSource绑定调用。对于ConvertBack方法，value参数是target的值，targetType参数实际上是source属性的类型。如果您知道将永远不会调用ConvertBack方法，则可以简单地忽略所有参数并从中返回null或0。使用一些值转换器，实现ConvertBack主体实际上是不可能的，但有时它非常简单（如本例所示）。
在代码中使用值转换器时，将转换器的实例设置为Binding的Converter属性。您可以选择通过设置Binding的ConverterParameter属性将参数传递给值转换器。
如果绑定也具有StringFormat，则值转换器返回的值是格式化为字符串的值。
通常，在XAML文件中，您需要在Resources字典中实例化值转换器，然后使用StaticResource在Binding表达式中引用它。值转换器不应该保持状态，因此可以在多个绑定之间共享。
这是使用值转换器的ButtonEnabler程序：

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit=
                 "clr-namespace:Xamarin.FormsBook.Toolkit;assembly=Xamarin.FormsBook.Toolkit" 
             x:Class="ButtonEnabler.ButtonEnablerPage"
             Padding="10, 50, 10, 0">
    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:IntToBoolConverter x:Key="intToBool" />
        </ResourceDictionary>
    </ContentPage.Resources> 
    <StackLayout Spacing="20">
        <Entry x:Name="entry"
               Text=""
               Placeholder="text to enable button" />
        <Button Text="Save or Send (or something)"
                FontSize="Medium"
                HorizontalOptions="Center"
                IsEnabled="{Binding Source={x:Reference entry},
                                    Path=Text.Length,
                                    Converter={StaticResource intToBool}}" />
    </StackLayout>
</ContentPage>

IntToBoolConverter在Resources字典中实例化，并作为Button的IsEnabled属性上设置的Binding中的嵌套标记扩展引用。
请注意，Text属性在Entry标记中显式初始化为空字符串。 默认情况下，Text属性为null，这意味着Text.Length的绑定Path设置不会产生有效值。
您可能还记得以前的章节中，仅在XAML中引用的Xamarin.FormsBook.Toolkit库中的类不足以建立从应用程序到库的链接。 因此，ButtonEnabler中的App构造函数调用Toolkit.Init：

public class App : Application
{
    public App()
    {
        Xamarin.FormsBook.Toolkit.Toolkit.Init();
        MainPage = new ButtonEnablerPage();
    }
    __
}

本章中使用Xamarin.Forms Book.Toolkit库的所有程序中都会出现类似的代码。
屏幕截图确认除非条目包含一些文本，否则不会启用Button：

如果您只使用值转换器的一个实例，则无需将其存储在“资源”字典中。 您可以在Binding标记中实例化它，使用target属性的property-element标签和Binding的Converter属性：

<Button Text="Save or Send (or something)"
        FontSize="Large"
        HorizontalOptions="Center">
    <Button.IsEnabled>
        <Binding Source="{x:Reference entry}"
                 Path="Text.Length">
            <Binding.Converter>
                <toolkit:IntToBoolConverter />
            </Binding.Converter>
        </Binding>
    </Button.IsEnabled>
</Button>

有时，值转换器可以方便地定义几个简单的属性。 例如，假设您要为Switch的两个设置显示一些文本，但您不想使用“True”和“False”，并且您不希望将替代值硬编码到值转换器中。 这是一个BoolToStringConverter，它包含两个文本字符串的公共属性：

namespace Xamarin.FormsBook.Toolkit
{
    public class BoolToStringConverter : IValueConverter
    {
        public string TrueText { set; get; }
        public string FalseText { set; get; }
        public object Convert(object value, Type targetType, 
                              object parameter, CultureInfo culture)
        {
            return (bool)value ? TrueText : FalseText;
        }
        public object ConvertBack(object value, Type targetType, 
                                  object parameter, CultureInfo culture)
        {
            return false;
        }
    }
}

Convert方法的主体是微不足道的：它只是根据布尔值参数在两个字符串之间进行选择。
类似的值转换器将布尔值转换为两种颜色之一：

namespace Xamarin.FormsBook.Toolkit
{
    public class BoolToColorConverter : IValueConverter
    {
        public Color TrueColor { set; get; }
        public Color FalseColor { set; get; }
        public object Convert(object value, Type targetType, 
                              object parameter, CultureInfo culture)
        {
            return (bool)value ? TrueColor : FalseColor;
        }
        public object ConvertBack(object value, Type targetType, 
                                  object parameter, CultureInfo culture)
        {
            return false;
        }
    }
}

SwitchText程序为两个不同的字符串对实例化BoolToStringConverter转换器两次：一次在Resources字典中，然后在Binding.Converter属性元素标记内。 最终Label的两个属性受BoolToStringConverter和BoolToColorConverter的影响，它们基于Switch的相同IsToggled属性：

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:toolkit=
                 "clr-namespace:Xamarin.FormsBook.Toolkit;assembly=Xamarin.FormsBook.Toolkit"
             x:Class="SwitchText.SwitchTextPage"
             Padding="10, 0">
    <ContentPage.Resources>
        <ResourceDictionary>
            <toolkit:BoolToStringConverter x:Key="boolToString"
                                           TrueText="Let's do it"
                                           FalseText="Not now" />
            <Style TargetType="Label">
                <Setter Property="FontSize" Value="Medium" />
                <Setter Property="VerticalOptions" Value="Center" />
            </Style>
        </ResourceDictionary>
    </ContentPage.Resources>
    <StackLayout>
    <!-- First Switch with text. -->
        <StackLayout Orientation="Horizontal"
                     VerticalOptions="CenterAndExpand">
            <Label Text="Learn more?" />
 
            <Switch x:Name="switch1"
                    VerticalOptions="Center" />
            <Label Text="{Binding Source={x:Reference switch1},
                   Path=IsToggled,
                   Converter={StaticResource boolToString}}"
                   HorizontalOptions="FillAndExpand" />
        </StackLayout>
        <!-- Second Switch with text. -->
        <StackLayout Orientation="Horizontal"
                     VerticalOptions="CenterAndExpand">
            <Label Text="Subscribe?" />
 
            <Switch x:Name="switch2"
                    VerticalOptions="Center" />
            <Label Text="{Binding Source={x:Reference switch2},
                                  Path=IsToggled,
                                  Converter={StaticResource boolToString}}"
                                  HorizontalOptions="FillAndExpand" />
        </StackLayout>
 
        <!-- Third Switch with text and color. -->
        <StackLayout Orientation="Horizontal"
                     VerticalOptions="CenterAndExpand">
            <Label Text="Leave page?" />
            <Switch x:Name="switch3"
                    VerticalOptions="Center" />
            <Label HorizontalOptions="FillAndExpand">
                <Label.Text>
                    <Binding Source="{x:Reference switch3}"
                             Path="IsToggled">
                        <Binding.Converter>
                            <toolkit:BoolToStringConverter TrueText="Yes"
                                                           FalseText="No" />
                        </Binding.Converter>
                    </Binding>
                </Label.Text>
                <Label.TextColor>
                    <Binding Source="{x:Reference switch3}"
                             Path="IsToggled">
                        <Binding.Converter>
                            <toolkit:BoolToColorConverter TrueColor="Green"
                                                          FalseColor="Red" />
                        </Binding.Converter>
                    </Binding>
                </Label.TextColor>
            </Label>
        </StackLayout>
    </StackLayout>
</ContentPage>

使用两个相当简单的绑定转换器，Switch现在可以显示两种状态所需的任何文本，并可以使用自定义颜色为该文本着色：

既然您已经看过BoolToStringConverter和BoolToColorConverter，您能否将该技术推广到任何类型的对象？ 这是Xamarin.FormsBook.Toolkit库中的通用BoolToObjectConverter：

public class BoolToObjectConverter<T> : IValueConverter
{
    public T TrueObject { set; get; }
    public T FalseObject { set; get; }
    public object Convert(object value, Type targetType, 
                          object parameter, CultureInfo culture)
    {
        return (bool)value ? this.TrueObject : this.FalseObject;
    }
    public object ConvertBack(object value, Type targetType, 
                              object parameter, CultureInfo culture)
    {
        return ((T)value).Equals(this.TrueObject);
    }
}

下一个示例使用此类。