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}"/>