在WPF（Windows Presentation Foundation）应用程序开发中，数据绑定是连接UI控件与业务逻辑数据的强大机制。然而，数据源中的原始数据格式往往不直接适用于界面的展示需求。例如，存储为字节数的整数可能需要转换为更易读的单位，如GB或TB。这时，WPF的值转换器（Value Converter）就显得尤为重要，它允许在数据从源流向目标或从目标流向源时，进行数据的转换和格式化。

本文将通过一个实例，演示如何创建一个自定义的值转换器，将表示文件大小的原始字节数转换为以GB（千兆字节）为单位的字符串，并将其显示在界面上。

1. 定义值转换器

首先，我们需要创建一个类，实现System.Windows.Data.IValueConverter接口。这个接口包含两个核心方法：Convert和ConvertBack。Convert方法用于将数据从源类型转换为目标类型（即显示在UI上的类型），而ConvertBack则用于反向转换（从UI类型转换回源类型）。

在这个例子中，我们将实现一个名为ByteToGigabyteConverter的转换器，它将一个长整数（字节数）转换为格式化后的GB字符串。

using System;
using System.Globalization;
using System.Windows.Data;

namespace WpfApp.Converters
{
    /// <summary>
    /// 将字节数转换为以GB为单位的字符串
    /// </summary>
    public class ByteToGigabyteConverter : IValueConverter
    {
        /// <summary>
        /// 将数据从源类型转换为目标类型。
        /// </summary>
        /// <param name="value">数据绑定源生成的值。</param>
        /// <param name="targetType">数据绑定目标属性的类型。>/param>
        /// <param name="parameter">要使用的转换器参数。</param>
        /// <param name="culture">要用于转换的区域性。</param>
        /// <returns>转换后的值。如果方法返回 null，则使用有效的 null 值。</returns>
        public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
        {
            if (value == null)
            {
                return Binding.DoNothing; // 如果值为 null，不进行任何操作
            }

            long byteCount;
            // 尝试将值解析为长整型字节数
            if (!long.TryParse(value.ToString(), out byteCount))
            {
                return Binding.DoNothing; // 如果解析失败，不更新目标
            }

            const double bytesInGigabyte = 1_000_000_000.0; // 1 GB = 10^9 字节 (十进制)
            double gigabytes = byteCount / bytesInGigabyte;

            // 格式化为两位小数，并追加 " GB" 单位
            return $"{gigabytes:F2} GB";
        }

        /// <summary>
        /// 将数据从目标类型转换回源类型。
        /// </summary>
        /// <param name="value">数据绑定目标生成的值。</param>
        /// <param name="targetType">要转换到的类型。</param>
        /// <param name="parameter">要使用的转换器参数。</param>
        /// <param name="culture">要用于转换的区域性。</param>
        /// <returns>转换后的值。如果方法返回 null，则使用有效的 null 值。</returns>
        public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
        {
            // 在此示例中，我们不需要将GB字符串转换回字节数，因此抛出不支持的异常。
            throw new NotSupportedException("Conversion from GB to Bytes is not supported for this converter.");
        }
    }
}

2. 准备主窗口逻辑

在主窗口的后台代码中，我们将创建一个ObservableCollection<string>来存储一些表示文件大小（字节数）的字符串数据。这些数据将作为ListBox的数据源。

using System.Collections.ObjectModel;
using System.Windows;

namespace WpfApp
{
    /// <summary>
    /// MainWindow.xaml 的交互逻辑
    /// </summary>
    public partial class MainWindow : Window
    {
        private ObservableCollection<string> _fileSizesInBytes;

        public MainWindow()
        {
            InitializeComponent();

            // 初始化文件大小数据，以字节为单位的字符串形式
            _fileSizesInBytes = new ObservableCollection<string>
            {
                "104857600",    // 大约 100 MB
                "5368709120",   // 大约 5 GB
                "10737418240",  // 大约 10 GB
                "214748364800", // 大约 200 GB
                "1099511627776" // 大约 1 TB
            };

            // 将 ListBox 的 ItemsSource 绑定到数据集合
            this.fileSizeListBox.ItemsSource = _fileSizesInBytes;
        }
    }
}

3. 设计WPF界面

在XAML界面中，我们将定义一个ListBox来显示原始的字节数列表，以及一个TextBlock来显示经过值转换器处理后的文件大小（GB单位）。

1. 在Window.Resources中声明我们的ByteToGigabyteConverter实例，并为其指定一个XAML键。
2. 将ListBox的ItemsSource绑定到我们后台代码中准备好的数据集合。
3. 将TextBlock的Text属性绑定到ListBox的SelectedItem。关键在于，我们通过Converter={StaticResource fileSizeConverter}引入了自定义的值转换器，确保选中的字节数能够被正确地转换为GB单位显示。

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:converters="clr-namespace:WpfApp.Converters" <!-- 引入转换器所在的命名空间 -->
        mc:Ignorable="d"
        Title="WPF自定义值转换器示例" Height="450" Width="600">
    
    <Window.Resources>
        <!-- 在资源中实例化我们的值转换器 -->
        <converters:ByteToGigabyteConverter x:Key="fileSizeConverter"/>
    </Window.Resources>
    
    <Grid>
        <StackPanel Margin="20">
            <TextBlock Text="选择文件大小 (原始字节数):" Margin="0,0,0,10" FontSize="14"/>
            
            <ListBox x:Name="fileSizeListBox" Height="150" Width="250" HorizontalAlignment="Left"
                     FontSize="12"/>
            
            <TextBlock Text="转换后的文件大小:" Margin="0,20,0,10" FontSize="14"/>
            
            <!-- TextBlock 绑定到 ListBox 的选中项，并应用自定义转换器 -->
            <TextBlock x:Name="convertedSizeTextBlock" FontSize="18" FontWeight="Bold" Foreground="DarkGreen"
                       Text="{Binding ElementName=fileSizeListBox, Path=SelectedItem, Converter={StaticResource fileSizeConverter}}"/>
        </StackPanel>
    </Grid>
</Window>

运行此应用程序时，您会看到一个列出原始字节数的ListBox。当您选择列表中的任何一项时，下方的TextBlock将实时显示该字节数经过ByteToGigabyteConverter转换和格式化后的GB单位值。