自学内容网 自学内容网
自学内容网 > 正文

WPF中MVVM工具包 CommunityToolkit.Mvvm

🕗 发布于 2024-11-12 01:42 wpf  MVVM  

CommunityToolkit.Mvvm，也称为MVVM工具包，是Microsoft Community Toolkit的一部分。它是一个轻量级但功能强大的MVVM（Model-View-ViewModel）库，旨在帮助开发者更容易地实现MVVM设计模式。

特点

  • 独立于平台和运行时：支持.NET Standard 2.0、.NET Standard 2.1 和 .NET 6，与UI框架无关，可在UWP、WinForms、WPF、Xamarin、Uno等平台上使用。
  • 易于选取和使用：对应用程序结构或编码范例没有严格需求，可以灵活使用。
  • 按需取用：自由选择要使用的组件，所有类型都是松散耦合的。
  • 引用实现：为基类库中包含的接口提供实现，但缺少直接使用它们所需的具体类型。

用法

  1. 安装：在Visual Studio中，通过NuGet包管理器搜索并安装CommunityToolkit.Mvvm包，
  2. 引用：在项目中添加using CommunityToolkit.Mvvm;来使用新API。
  3. 实现MVVM：通过继承ObservableObject来创建ViewModel，利用SetProperty方法实现属性变更通知，以及使用RelayCommand或AsyncRelayCommand来实现命令模式。

功能

该库提供了一些基础类和接口的实现，主要包括：

  • ObservableObject 和 ObservableRecipient：这些类实现了INotifyPropertyChanged接口，并提供了SetProperty方法，可以在属性值改变时触发PropertyChanged事件，简化数据绑定。
  • ICommand接口的实现，如RelayCommand和AsyncRelayCommand：这些类可以帮助创建命令，命令是MVVM模式中的一个重要组成部分。
  • IMessenger和相关消息传递机制，如WeakReferenceMessenger和StrongReferenceMessenger，用于组件间的松散耦合通信。

CommunityToolkit.Mvvm 包含的类型主要分为以下几个部分：

  1. CommunityToolkit.Mvvm.ComponentModel
    • ObservableObject：实现了 INotifyPropertyChanged 接口，用于创建响应属性变化的ViewModel。
    • ObservableRecipient：用于消息传递的基类。
    • ObservableValidator：用于数据验证的基类。
  2. CommunityToolkit.Mvvm.DependencyInjection
    • Ioc：提供依赖注入的容器和相关服务。
  3. CommunityToolkit.Mvvm.Input
    • RelayCommand：一个简单的命令实现，用于执行无参方法。
    • RelayCommand<T>：一个泛型版本的 RelayCommand，用于执行带参方法。
    • AsyncRelayCommand：一个异步命令实现，用于执行异步无参方法。
    • AsyncRelayCommand<T>：一个异步命令实现，用于执行异步带参方法。
    • IRelayCommand：RelayCommand 的接口定义。
    • IRelayCommand<T>：RelayCommand<T> 的接口定义。
    • IAsyncRelayCommand：AsyncRelayCommand 的接口定义。
    • IAsyncRelayCommand<T>：AsyncRelayCommand<T> 的接口定义。
  4. CommunityToolkit.Mvvm.Messaging
    • IMessenger：消息传递接口，定义了消息发送和订阅的方法。
    • WeakReferenceMessenger：一个使用弱引用的消息传递类，用于避免内存泄漏。
    • StrongReferenceMessenger：一个使用强引用的消息传递类。
    • IRecipient<TMessage>：消息接收者接口，用于接收特定类型的消息。
    • MessageHandler<TRecipient, TMessage>：消息处理程序，用于处理特定类型的消息。
  5. CommunityToolkit.Mvvm.Messaging.Messages
    • PropertyChangedMessage<T>：用于属性变化的消息。
    • RequestMessage<T>：用于请求特定类型响应的消息。
    • AsyncRequestMessage<T>：异步版本的 RequestMessage<T>。
    • CollectionRequestMessage<T>：用于集合操作的请求消息。
    • AsyncCollectionRequestMessage<T>：异步版本的 CollectionRequestMessage<T>。
    • ValueChangedMessage<T>：用于值变化的消息。

CommunityToolkit.Mvvm 还提供了一些关键属性和功能

  1. ObservableObject
    • ObservableObject 是 CommunityToolkit.Mvvm 库中的一个基础类，它实现了 INotifyPropertyChanged 接口。这个接口是 .NET 数据绑定基础架构的一部分，当对象的一个属性改变时，它会通知绑定到该属性的任何元素。
    • 用法：ViewModel 通常会继承自 ObservableObject 类。
    • 示例代码： 
      public class MyViewModel : ObservableObject
{
    private string _myProperty;
    public string MyProperty
    {
        get => _myProperty;
        set => SetProperty(ref _myProperty, value);
    }
}
  2. [ObservableProperty] 属性
    • [ObservableProperty] 是一个特性（Attribute），用于自动生成可观察属性的 getter 和 setter，这些属性会在值改变时触发 PropertyChanged 事件。
    • 用法：直接在 ViewModel 的属性上使用 [ObservableProperty] 特性。
    • 示例代码： 
      public partial class MyViewModel : ObservableObject
{
    [ObservableProperty]
    private string? _name;
}
      这将生成一个类似下面的可观察属性： 
      public string? Name
{
    get => _name;
    set => SetProperty(ref _name, value);
}
  3. [RelayCommand] 属性
    • [RelayCommand] 是一个特性，用于创建命令。命令是 MVVM 模式中的一个重要组成部分，用于将 View 的行为（如按钮点击）绑定到 ViewModel 中的方法。
    • 用法：在 ViewModel 中的方法上使用 [RelayCommand] 特性。
    • 示例代码： 
      public partial class MyViewModel : ObservableObject
{
    [RelayCommand]
    private void ExecuteCommand()
    {
        // Command execution logic here
    }
}
      这将生成一个 ICommand 实现，可以被 View 绑定。
其他属性

  1. RelayCommand 和 AsyncRelayCommand：

    • 这些类实现了 ICommand 接口，用于创建命令，是 MVVM 模式中命令模式的实现。

  2. IMessenger：

    • 消息传递接口，用于在不同的 ViewModel 或 View 之间传递消息，实现组件间的松散耦合通信。

  3. PropertyChangedMessage<T>：

    • 用于属性变化的消息，是 IMessenger 接口实现中用于传递属性变更通知的一种消息类型。

  4. RequestMessage<T> 和 AsyncRequestMessage<T>：

    • 用于请求特定类型响应的消息，其中 AsyncRequestMessage<T> 是异步版本的请求消息。

  5. CollectionRequestMessage<T> 和 AsyncCollectionRequestMessage<T>：

    • 用于集合操作的请求消息，其中 AsyncCollectionRequestMessage<T> 是异步版本的集合请求消息。

  6. ValueChangedMessage<T>：

    • 用于值变化的消息，是 IMessenger 接口实现中用于传递值变更通知的一种消息类型。

CommunityToolkit.Mvvm 的框架类 

  1. CommunityToolkit.Mvvm.ComponentModel
    • ObservableObject：实现了 INotifyPropertyChanged 和 INotifyPropertyChanging 接口，用于创建响应属性变化的 ViewModel。
    • ObservableRecipient：用于消息传递的基类。
    • ObservableValidator：用于数据验证的基类。
  2. CommunityToolkit.Mvvm.DependencyInjection
    • Ioc：提供依赖注入的容器和相关服务。
  3. CommunityToolkit.Mvvm.Input
    • RelayCommand：一个简单的命令实现，用于执行无参方法。
    • RelayCommand<T>：一个泛型版本的 RelayCommand，用于执行带参方法。
    • AsyncRelayCommand：一个异步命令实现，用于执行异步无参方法。
    • AsyncRelayCommand<T>：一个异步命令实现，用于执行异步带参方法。
    • IRelayCommand：RelayCommand 的接口定义。
    • IRelayCommand<T>：RelayCommand<T> 的接口定义。
    • IAsyncRelayCommand：AsyncRelayCommand 的接口定义。
    • IAsyncRelayCommand<T>：AsyncRelayCommand<T> 的接口定义。
  4. CommunityToolkit.Mvvm.Messaging
    • IMessenger：消息传递接口，定义了消息发送和订阅的方法。
    • WeakReferenceMessenger：一个使用弱引用的消息传递类，用于避免内存泄漏。
    • StrongReferenceMessenger：一个使用强引用的消息传递类。
    • IRecipient<TMessage>：消息接收者接口，用于接收特定类型的消息。
    • MessageHandler<TRecipient, TMessage>：消息处理程序，用于处理特定类型的消息。
  5. CommunityToolkit.Mvvm.Messaging.Messages
    • PropertyChangedMessage<T>：用于属性变化的消息。
    • RequestMessage<T>：用于请求特定类型响应的消息。
    • AsyncRequestMessage<T>：异步版本的 RequestMessage<T>。
    • CollectionRequestMessage<T>：用于集合操作的请求消息。
    • AsyncCollectionRequestMessage<T>：异步版本的 CollectionRequestMessage<T>。
    • ValueChangedMessage<T>：用于值变化的消息。

CommunityToolkit.Mvvm是一个现代、快速和模块化的MVVM库，它提供了尽可能大的灵活性，让开发人员可以自由选择要使用的组件，以最符合需求的方式组合这些生成块。 


原文地址：https://blog.csdn.net/2302_77639120/article/details/143696362

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

相关文章

自学内容网
Copyright © 2015-2024