功能更新

Melskin/Converters/Internal/PropertyValueConverter.cs

@@ -0,0 +1,59 @@
+// Cascader.cs
+
+using System.Globalization;
+using System.Windows.Data;
+
+namespace Melskin.Converters.Internal;
+
+/// <summary>
+/// 该类实现了 IMultiValueConverter 接口，用于将多个绑定值转换为单个输出值。特别适用于需要从数据项中动态获取属性值的场景，
+/// 比如在 WPF 的 MultiBinding 中使用时，可以根据提供的属性名称动态地获取对象的属性值。
+/// </summary>
+internal class PropertyValueConverter : IMultiValueConverter
+{
+    /// <summary>
+    /// 代表 PropertyValueConverter 类的单例实例。此实例在整个应用程序中可重用，用于在数据绑定中执行属性值转换。
+    /// 它特别适用于需要将多个源值（如数据项和属性名称）转换为单一输出值的情况。
+    /// </summary>
+    public static readonly PropertyValueConverter Instance = new();
+
+    /// <inheritdoc />
+    public object? Convert(object[]? values, Type targetType, object parameter, CultureInfo culture)
+    {
+        // 根据 MultiBinding 的定义，我们期望：
+        // values[0] 是当前的数据项 (例如 Staff 对象)
+        // values[1] 是 DisplayMemberPath 属性的值 (例如 "Name" 字符串)
+
+        if (values == null || values.Length < 2 || values[0] == null || values[1] == null)
+        {
+            return null;
+        }
+
+        var dataItem = values[0];
+        var propertyName = values[1].ToString();
+
+        if (string.IsNullOrEmpty(propertyName))
+        {
+            // 如果没有提供 DisplayMemberPath，则回退到调用 .ToString()
+            return dataItem.ToString();
+        }
+
+        try
+        {
+            // 使用反射动态获取属性的值
+            var propertyInfo = dataItem.GetType().GetProperty(propertyName);
+            return propertyInfo?.GetValue(dataItem);
+        }
+        catch
+        {
+            // 如果属性不存在或发生其他错误，返回 null
+            return null;
+        }
+    }
+
+    /// <inheritdoc />
+    public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture)
+    {
+        throw new NotImplementedException();
+    }
+}