.NET MAUI自定义控件绑定属性无法获取值问题求助

你的ValidationFor控件无法获取FieldName和ShowValidationError的设置值，核心问题集中在这几个方面：

1. 构造函数过早访问绑定属性 #

控件构造函数执行时，XAML中设置的绑定属性值还未被应用，此时FieldName为空字符串，导致后续获取子元素、绑定事件等逻辑全部失效。

2. 错误使用GetTemplateChild方法 #

GetTemplateChild是用于从ControlTemplate中获取元素的API，而你的控件是直接包裹子元素，应该通过Content属性访问内部控件。

3. 自定义PropertyChanged事件不符合规范 #

ContentView继承自BindableObject，后者已经实现了INotifyPropertyChanged接口，无需自行声明事件，应使用基类的OnPropertyChanged方法通知属性变更。

4. 绑定属性未设置变更回调 #

没有为FieldNameProperty和ShowValidationErrorProperty添加属性变更回调，无法在属性值更新时触发后续验证逻辑。

修改后的完整代码 #

1. 修正后的控件逻辑 #

public partial class ValidationFor : ContentView
{
    // 移除自定义的PropertyChanged事件，使用基类实现

    public static readonly BindableProperty FieldNameProperty =
        BindableProperty.Create(
            nameof(FieldName), 
            typeof(string), 
            typeof(ValidationFor),
            propertyChanged: OnFieldNameChanged); // 添加属性变更回调

    public static readonly BindableProperty ShowValidationErrorProperty =
        BindableProperty.Create(
            nameof(ShowValidationError), 
            typeof(bool), 
            typeof(ValidationFor),
            defaultValue: false, // 设置默认值
            propertyChanged: OnShowValidationErrorChanged); // 添加属性变更回调

    public string FieldName
    {
        get => (string)GetValue(FieldNameProperty);
        set => SetValue(FieldNameProperty, value);
    }

    public bool ShowValidationError
    {
        get => (bool)GetValue(ShowValidationErrorProperty);
        set => SetValue(ShowValidationErrorProperty, value);
    }

    private string _errorMessage = string.Empty;
    public string ErrorMessage
    {
        get => _errorMessage;
        private set
        {
            _errorMessage = value;
            OnPropertyChanged(); // 使用基类方法通知属性变更
        }
    }

    private Visibility _isValid = Visibility.Hidden;
    public Visibility IsValid
    {
        get => _isValid;
        private set
        {
            _isValid = value;
            OnPropertyChanged(); // 使用基类方法通知属性变更
        }
    }

    private object _childElement;

    public ValidationFor()
    {
        InitializeComponent();
        // 监听子控件变更事件
        this.ContentChanged += OnContentChanged;
    }

    // 子控件变更时触发
    private void OnContentChanged(object sender, EventArgs e)
    {
        // 移除旧控件的事件绑定
        if (_childElement is INotifyPropertyChanged oldElement)
        {
            oldElement.PropertyChanged -= ValueChanged;
        }

        _childElement = this.Content;
        // 绑定新控件的属性变更事件
        if (_childElement is INotifyPropertyChanged newElement)
        {
            newElement.PropertyChanged += ValueChanged;
            // 初始验证一次
            Validate(_childElement);
        }
    }

    // FieldName属性变更时触发
    private static void OnFieldNameChanged(BindableObject bindable, object oldValue, object newValue)
    {
        if (bindable is ValidationFor validationControl && newValue is string fieldName)
        {
            validationControl.Validate(validationControl._childElement);
        }
    }

    // ShowValidationError属性变更时触发
    private static void OnShowValidationErrorChanged(BindableObject bindable, object oldValue, object newValue)
    {
        if (bindable is ValidationFor validationControl)
        {
            validationControl.Validate(validationControl._childElement);
        }
    }

    private void ValueChanged(object sender, PropertyChangedEventArgs args)
    {
        if (string.IsNullOrEmpty(FieldName)) return;
        
        var targetProperty = FieldName.Split('.').Last();
        if (args.PropertyName == targetProperty)
        {
            Validate(sender);
        }
    }

    private void Validate(object element)
    {
        if (element == null || string.IsNullOrEmpty(FieldName)) return;

        var targetProperty = FieldName.Split('.').Last();
        var propertyInfo = element.GetType().GetProperty(targetProperty);
        if (propertyInfo == null) return;

        dynamic value = propertyInfo.GetValue(element);
        var results = new List<ValidationResult>();

        var context = new ValidationContext(element) { MemberName = targetProperty };
        Validator.TryValidateProperty(value, context, results);

        if (results.Any())
        {
            if (!ShowValidationError)
            {
                ErrorMessage = results.First().ErrorMessage;
                IsValid = Visibility.Visible;
            }
            else
            {
                ErrorMessage = null;
                IsValid = Visibility.Hidden;
            }
        }
        else
        {
            ErrorMessage = null;
            IsValid = Visibility.Hidden;
        }
    }
}

2. 配套XAML模板示例 #

如果你的ValidationFor有对应的XAML文件，需要正确绑定错误信息和显示状态：

<!-- ValidationFor.xaml -->
<ContentView xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="ValidationLibrary.ValidationFor">
    <VerticalStackLayout>
        <!-- 显示包裹的子控件 -->
        <ContentPresenter Content="{Binding Content, Source={RelativeSource AncestorType={x:Type local:ValidationFor}}}" />
        <!-- 显示错误提示 -->
        <Label Text="{Binding ErrorMessage, Source={RelativeSource AncestorType={x:Type local:ValidationFor}}}"
               TextColor="Red"
               IsVisible="{Binding IsValid, Source={RelativeSource AncestorType={x:Type local:ValidationFor}}}" />
    </VerticalStackLayout>
</ContentView>

关键修复点总结 #

• 为绑定属性添加propertyChanged回调，确保属性值更新时触发验证逻辑
• 通过ContentChanged事件监听子控件变更，避免构造函数中过早访问未初始化内容
• 使用基类的OnPropertyChanged方法通知属性变更，符合.NET MAUI绑定规范
• 修正子控件获取方式，从Content属性而非GetTemplateChild获取内部控件

内容的提问来源于stack exchange，提问作者Wasyster