快捷導(dǎo)航

基于WPF實現(xiàn)簡單的值轉(zhuǎn)換器

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

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

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;
        }
    }
}

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

1. ValueConverterBase 類

ValueConverterBase 是一個抽象類，實現(xiàn)了 IValueConverter 接口。IValueConverter 是 WPF 中用于定義值轉(zhuǎn)換器的接口，通常用于數(shù)據(jù)綁定中的值轉(zhuǎn)換。

代碼解析

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;
    }
}

關(guān)鍵點

Convert 方法：

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

ConvertBack 方法：

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

DependencyProperty.UnsetValue：

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

2. DatetimeConverter 類

DatetimeConverter 是 ValueConverterBase 的具體實現(xiàn)，用于將 DateTime 類型的值轉(zhuǎn)換為字符串格式。

代碼解析

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;
    }
}

關(guān)鍵點

Convert 方法的實現(xiàn)：

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

ConvertBack 方法：

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

3. 使用場景

在 WPF 中，ValueConverter 通常用于數(shù)據(jù)綁定，將數(shù)據(jù)模型中的值轉(zhuǎn)換為適合 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：為轉(zhuǎn)換器分配一個鍵，以便在 XAML 中引用。
Binding：將 TextBox 的 Text 屬性綁定到 DateTimeProperty，并使用 DatetimeConverter 進行格式化。