基于WPF實現簡單的值轉換器

更新時間：2025年02月26日 08:21:39 作者：慕仲卿

值轉換器是?WPF?項目中具有特色的組成部分,這篇文章將帶大家實現一個標準的值轉換器,文中的示例代碼講解詳細,有需要的小伙伴可以參考一下

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Data;

namespace ConverterDemo.Converts
{
    public abstract class ValueConverterBase : IValueConverter
    {
        public abstract object Convert(object value, Type targetType, object parameter, CultureInfo culture);

        public virtual object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        {
            return DependencyProperty.UnsetValue;
        }
    }
}

---

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace ConverterDemo.Converts
{
    public class DatetimeConverter : ValueConverterBase
    {
        public override object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            string result = "";
            if (value is DateTime data)
            {
                DateTime time = (DateTime)data;
                result = time.ToString("yyyy-MM-dd HH:mm:ss");
            }
            return result;
        }
    }
}

這段代碼定義了一個值轉換器（ValueConverter），用于在 WPF 應用程序中將數據綁定中的值從一種類型轉換為另一種類型。這種轉換器通常用于在 UI 層和數據模型之間進行數據格式化或邏輯轉換。以下是對代碼的詳細解釋：

1. ValueConverterBase 類

ValueConverterBase 是一個抽象類，實現了 IValueConverter 接口。IValueConverter 是 WPF 中用于定義值轉換器的接口，通常用于數據綁定中的值轉換。

代碼解析

public abstract class ValueConverterBase : IValueConverter
{
    public abstract object Convert(object value, Type targetType, object parameter, CultureInfo culture);

    public virtual object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return DependencyProperty.UnsetValue;
    }
}

關鍵點

Convert 方法：

作用：將綁定源的值轉換為目標類型。
參數：
- value：綁定源的值。
- targetType：目標屬性的類型。
- parameter：可選的轉換參數。
- culture：用于格式化和解析的區(qū)域設置。
返回值：轉換后的值。

ConvertBack 方法：

作用：將目標值轉換回綁定源的值（用于雙向綁定）。
默認實現：返回 DependencyProperty.UnsetValue，表示不支持反向轉換。這在單向綁定中是常見的行為。

DependencyProperty.UnsetValue：

這是一個特殊的值，表示屬性沒有設置值。在 WPF 中，它通常用于表示綁定失敗或不支持的操作。

2. DatetimeConverter 類

DatetimeConverter 是 ValueConverterBase 的具體實現，用于將 DateTime 類型的值轉換為字符串格式。

代碼解析

public class DatetimeConverter : ValueConverterBase
{
    public override object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        string result = "";
        if (value is DateTime data)
        {
            DateTime time = (DateTime)data;
            result = time.ToString("yyyy-MM-dd HH:mm:ss");
        }
        return result;
    }
}

關鍵點

Convert 方法的實現：

檢查 value 是否是 DateTime 類型。
如果是，將其格式化為 "yyyy-MM-dd HH:mm:ss" 格式的字符串。
如果不是，返回空字符串 ""。

ConvertBack 方法：

由于 DatetimeConverter 沒有顯式實現 ConvertBack 方法，它繼承了 ValueConverterBase 的默認實現，返回 DependencyProperty.UnsetValue。

3. 使用場景

在 WPF 中，ValueConverter 通常用于數據綁定，將數據模型中的值轉換為適合 UI 顯示的格式。例如，你可能有一個 DateTime 類型的屬性，但希望在 UI 中以特定的字符串格式顯示。

XAML 示例

<Window.Resources>
    <local:DatetimeConverter x:Key="DatetimeConverter" />
</Window.Resources>

<TextBox Text="{Binding DateTimeProperty, Converter={StaticResource DatetimeConverter}}" />

local:DatetimeConverter：引用 DatetimeConverter 類。
x:Key：為轉換器分配一個鍵，以便在 XAML 中引用。
Binding：將 TextBox 的 Text 屬性綁定到 DateTimeProperty，并使用 DatetimeConverter 進行格式化。