RelayCommand and RelayCommand<T>

RelayCommand a RelayCommand<T> jsou implementace ICommand, které mohou zpřístupnit metodu nebo delegáta pro zobrazení. Tyto typy fungují jako způsob, jak svázat příkazy mezi prvky viewmodelu a uživatelského rozhraní.

Rozhraní API platformy:RelayCommand, RelayCommand<T>IRelayCommand,IRelayCommand<T>

Jak fungují

RelayCommand a RelayCommand<T> mají následující hlavní funkce:

• Poskytují základní implementaci ICommand rozhraní.
• Také implementují IRelayCommand (a IRelayCommand<T>) rozhraní, které zveřejňuje metodu NotifyCanExecuteChanged pro vyvolání CanExecuteChanged události.
• Zpřístupňují konstruktory, které přijímají delegáty jako Action a Func<T> a umožňují zapouzdření standardních metod a výrazů lambda.

Práce s ICommand

Následující příklad ukazuje, jak nastavit jednoduchý příkaz:

public class MyViewModel : ObservableObject
{
    public MyViewModel()
    {
        IncrementCounterCommand = new RelayCommand(IncrementCounter);
    }

    private int counter;

    public int Counter
    {
        get => counter;
        private set => SetProperty(ref counter, value);
    }

    public ICommand IncrementCounterCommand { get; }

    private void IncrementCounter() => Counter++;
}

A relativní uživatelské rozhraní pak může být (pomocí WinUI XAML):

<Page
    x:Class="MyApp.Views.MyPage"
    xmlns:viewModels="using:MyApp.ViewModels">
    <Page.DataContext>
        <viewModels:MyViewModel x:Name="ViewModel"/>
    </Page.DataContext>

    <StackPanel Spacing="8">
        <TextBlock Text="{x:Bind ViewModel.Counter, Mode=OneWay}"/>
        <Button
            Content="Click me!"
            Command="{x:Bind ViewModel.IncrementCounterCommand}"/>
    </StackPanel>
</Page>

Button je navázán na ICommand ve viewmodelu, který zapouzdřuje privátní metodu IncrementCounter. TextBlock zobrazuje hodnotu vlastnosti Counter a aktualizuje se při každé změně hodnoty této vlastnosti.

Příklady

• Podívejte se na ukázkovou aplikaci (pro více architektur uživatelského rozhraní) a podívejte se na sadu nástrojů MVVM v akci.
• Další příklady najdete také v jednotkových testech.