WPFCommandParameter詳解

一、WPFCommandParameter介紹

WPFCommandParameter是WPF命令(Command)系統中的一部分，它允許我們向命令傳遞一些額外的信息，以便在執行命令時使用這些信息，達到更好的交互效果。在最常見的情況下，這些參數可以是綁定到命令的UI元素中的值。

舉個例子，當我們使用按鈕(Button)或菜單項(MenuItem)等UI元素表示執行某項操作時，我們可以使用CommandBinding，通過綁定命令來響應用戶操作。而WPFCommandParameter則是作為CommandBinding的一個屬性或者CommandBinding的默認操作目標(Target)的屬性存在，為命令的執行提供必需的信息。

二、WPFCommandParameter的優勢

WPFCommandParameter的優勢一方面表現在它可以幫助我們定義更加靈活的命令，另一方面它可以幫助我們編寫更少的代碼。

1、更加靈活的命令

對於一些複雜的功能，我們可能需要使用不同的UI元素來觸發同一個命令。例如，我們可以通過按鈕、文本框或者菜單項來觸發打開文件的命令。如果我們使用WPFCommandParameter，我們可以通過傳入命令參數來區分不同的調用者。在命令處理函數中，我們可以根據參數值來判斷是哪個UI元素調用了命令。這使得我們可以通過一個命令來處理多個UI元素的點擊事件，並且避免了編寫多個相同功能的命令的麻煩。

2、更少的代碼

如果沒有WPFCommandParameter，那麼在執行命令時我們需要通過CommandParameter屬性來傳遞參數。使用WPFCommandParameter可以直接通過一條語句在XAML中指定參數的值，從而避免了在代碼中為命令設置參數的麻煩。

三、WPFCommandParameter的使用

WPFCommandParameter的使用非常簡單，我們只需要在XAML中聲明一個CommandParameter元素，並且在其中指定參數值即可。以下是使用WPFCommandParameter來傳遞字符串參數的示例：

<Button Content="Open File" Command="{Binding OpenCommand}">
    <Button.CommandParameter>
        <system:String>c:\temp\test.txt</system:String>
    </Button.CommandParameter>
</Button>

在這個例子中，我們通過指定一個OpenCommand命令來響應按鈕的點擊事件，並且通過CommandParameter來傳入了一個字符串參數。通過這個字符串參數，我們就可以在處理OpenCommand的命令處理器中來打開相應的文件。

四、WPFCommandParameter示例代碼

1、在ViewModel中定義OpenCommand

public class MainWindowViewModel : INotifyPropertyChanged
{
    public MainWindowViewModel()
    {
        OpenCommand = new RelayCommand(OpenFile);
    }

    public ICommand OpenCommand { get; private set; }

    private void OpenFile(string filePath)
    {
        // 控制台輸出文件路徑
        Console.WriteLine($"Open file：{filePath}");
    }

    // INotifyPropertyChanged 實現省略
    
}

2、在XAML中引用OpenCommand

<Window x:Class="WpfApp1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:WpfApp1"
        Title="MainWindow" Height="450" Width="800">

    <Window.DataContext>
        <local:MainWindowViewModel />
    </Window.DataContext>

    <StackPanel>
        <Button Content="Open File" Command="{Binding OpenCommand}">
            <Button.CommandParameter>
                <system:String>c:\temp\test.txt</system:String>
            </Button.CommandParameter>
        </Button>
        <Button Content="Open Document" Command="{Binding OpenCommand}">
            <Button.CommandParameter>
                <system:String>c:\documents\test.docx</system:String>
            </Button.CommandParameter>
        </Button>
        <TextBox Width="200" Margin="10" Text="{Binding Text}" />
        <Button Content="Search" Command="{Binding SearchCommand}" CommandParameter="{Binding Text}" />
    </StackPanel>

</Window>

在這個例子中，我們在XAML中使用了兩個按鈕(Button)。我們分別使用了相同的OpenCommand，並且通過Button.CommandParameter元素來傳入了不同的文件路徑參數。另外，在第三個按鈕(Button)中我們通過CommandParameter直接綁定了Text屬性，從而在命令處理器中來獲取用戶輸入的字符串。

五、總結

通過WPFCommandParameter，我們可以更加靈活地定義命令，同時減少編寫重複代碼的工作量。在使用WPF命令時，我們應該積極地考慮是否需要使用WPFCommandParameter來傳遞額外的參數。