WPF：如何实现Window到UserControl及其ViewModel的数据传递？

最优方案：用依赖属性替代Tag传递数据 #

Tag属性是通用附加属性，缺乏类型安全，也不符合WPF控件数据传递的标准范式。依赖属性才是UserControl接收外部数据的正确方式，它支持绑定、属性变更通知、类型校验，还能避开控件未初始化完成的问题。

具体实现步骤 #

1. 给NoteHeadControl添加依赖属性

可以选择传递整个Note对象（更灵活，后续扩展subject、text等字段无需改代码），或单独传递Id。这里以传递整个Note为例：

public partial class NoteHeadControl : UserControl
{
    // 定义绑定整个Note对象的依赖属性
    public static readonly DependencyProperty NoteProperty =
        DependencyProperty.Register(nameof(Note), typeof(Note), typeof(NoteHeadControl),
            new PropertyMetadata(null));

    public Note Note
    {
        get => (Note)GetValue(NoteProperty);
        set => SetValue(NoteProperty, value);
    }

    public NoteHeadControl()
    {
        InitializeComponent();
        DataContext = new NoteHeadControlViewModel();
    }
}

2. 在UserControl的XAML中绑定ViewModel属性

直接把依赖属性的值绑定到ViewModel的对应字段，无需在后台代码手动赋值：

<UserControl x:Class="YourNamespace.NoteHeadControl"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:YourNamespace">
    <UserControl.DataContext>
        <local:NoteHeadControlViewModel />
    </UserControl.DataContext>

    <StackPanel>
        <TextBlock Text="{Binding Note.Subject}" />
        <Button Content="删除" 
                Command="{Binding DeleteNoteCommand}"
                CommandParameter="{Binding Note.Id}" />
    </StackPanel>
</UserControl>

3. ViewModel接收参数并实现删除命令

ViewModel中直接通过绑定拿到Note或Id，执行删除逻辑：

public class NoteHeadControlViewModel : INotifyPropertyChanged
{
    private Note _note;
    public Note Note
    {
        get => _note;
        set
        {
            _note = value;
            OnPropertyChanged();
        }
    }

    public ICommand DeleteNoteCommand { get; }

    public NoteHeadControlViewModel()
    {
        DeleteNoteCommand = new RelayCommand<int>(ExecuteDeleteNote);
    }

    private void ExecuteDeleteNote(int noteId)
    {
        // 这里写删除逻辑，比如调用服务或操作集合移除对应Id的Note
        Console.WriteLine($"删除ID为{noteId}的笔记");
    }

    public event PropertyChangedEventHandler PropertyChanged;
    protected void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

// 实现一个通用的RelayCommand（可复用）
public class RelayCommand<T> : ICommand
{
    private readonly Action<T> _execute;
    private readonly Func<T, bool> _canExecute;

    public event EventHandler CanExecuteChanged
    {
        add => CommandManager.RequerySuggested += value;
        remove => CommandManager.RequerySuggested -= value;
    }

    public RelayCommand(Action<T> execute, Func<T, bool> canExecute = null)
    {
        _execute = execute ?? throw new ArgumentNullException(nameof(execute));
        _canExecute = canExecute;
    }

    public bool CanExecute(object parameter) => _canExecute?.Invoke((T)parameter) ?? true;
    public void Execute(object parameter) => _execute((T)parameter);
}

4. 在ListBox中绑定UserControl的依赖属性

在主窗口的ListBox ItemTemplate中，直接把集合中的Note项绑定到UserControl的Note依赖属性：

<ListBox ItemsSource="{Binding NoteList}">
    <ListBox.ItemTemplate>
        <DataTemplate>
            <local:NoteHeadControl Note="{Binding}" />
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

为什么能避开控件未初始化的问题 #

UserControl构造函数执行时，XAML内的控件还未完成实例化，所以直接访问OpenButton这类控件会返回null。而依赖属性的绑定会在控件初始化完成后自动生效，ViewModel能通过绑定直接拿到数据，完全不需要在构造函数中手动读取控件属性。

内容的提问来源于stack exchange，提问作者Черный Камень