IValueConverter 接口

 

提供一种将自定义逻辑应用于绑定的方式。

 

命名空间：  System.Windows.Data
程序集：  PresentationFramework（在 PresentationFramework.dll 中） 

 

  语法

Visual Basic（声明）

Public Interface IValueConverter

Visual Basic (用法)

Dim instance As IValueConverter

C#

public interface IValueConverter

Visual C++

public interface class IValueConverter

J#

public interface IValueConverter

JScript

public interface IValueConverter

XAML

可以直接在 XAML 中使用接口，请参见实现该接口的类型。

 

  备注

 

如果要将值转换器与绑定关联，请创建一个实现 IValueConverter 接口的类，然后实现Convert 和 ConvertBack 方法。转换器可以将数据从一种类型更改为另一种类型，根据区域性信息转换数据，或修改表示形式的其他方面。

 

值转换器是分区域性的。Convert 和 ConvertBack 方法都具有指示区域性信息的 culture 参数。如果区域性信息与转换无关，那么在自定义转换器中可以忽略该参数。

 

Convert 和 ConvertBack 方法还具有名为 parameter 的参数，以便您能将转换器的同一个实例与不同参数一起使用。例如，您可以编写格式设置转换器，以根据所用的输入参数生成不同的数据格式。可以使用 Binding 类的 ConverterParameter，将参数作为变量传递给Convert 和 ConvertBack 方法。

 

  示例

 

本示例演示如何将转换应用于绑定中使用的数据。

 

要在绑定期间转换数据，必须创建一个实现 IValueConverter 接口的类，其中包括 Convert和 ConvertBack 方法。

 

下面的示例演示一个日期转换器的实现，此日期转换器转换传入的日期值，使其只显示年月日。实现 IValueConverter 接口时，最好用 ValueConversionAttribute 属性来修饰此实现，以便向开发工具指示转换所涉及的数据类型，如下面的示例所示：

 

C#

 

[ValueConversion(typeof(DateTime), typeof(String))]
public class DateConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        DateTime date = (DateTime)value;
        return date.ToShortDateString();
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        string strValue = value.ToString();
        DateTime resultDateTime;
        if (DateTime.TryParse(strValue, out resultDateTime))
        {
            return resultDateTime;
        }
        return value;
    }
}

 

一旦创建了转换器，即可将其作为一项资源添加到可扩展应用程序标记语言 (XAML) 文件中。在下面的示例中，src 映射到在其中定义 DateConverter 的命名空间。

 

C#

 

<src:DateConverter x:Key="dateConverter"/>

 

 

最后，通过以下语法在绑定中使用转换器。在下面的示例中，TextBlock 的文本内容绑定到StartDate，后者是外部数据源的一个属性。

 

C#

 

<TextBlock Grid.Row="2" Grid.Column="0" Margin="0,0,8,0"
           Name="startDateTitle"
           Style="{StaticResource smallTitleStyle}">Start Date:</TextBlock>
<TextBlock Name="StartDateDTKey" Grid.Row="2" Grid.Column="1"
    Text="{Binding Path=StartDate, Converter={StaticResource dateConverter}}"
    Style="{StaticResource textStyleTextBlock}"/>