DSoft.System.Mvvm 3.0.2110.41-prerelease

This is a prerelease version of DSoft.System.Mvvm.
There is a newer version of this package available.
See the version list below for details.
dotnet add package DSoft.System.Mvvm --version 3.0.2110.41-prerelease                
NuGet\Install-Package DSoft.System.Mvvm -Version 3.0.2110.41-prerelease                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="DSoft.System.Mvvm" Version="3.0.2110.41-prerelease" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add DSoft.System.Mvvm --version 3.0.2110.41-prerelease                
#r "nuget: DSoft.System.Mvvm, 3.0.2110.41-prerelease"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install DSoft.System.Mvvm as a Cake Addin
#addin nuget:?package=DSoft.System.Mvvm&version=3.0.2110.41-prerelease&prerelease

// Install DSoft.System.Mvvm as a Cake Tool
#tool nuget:?package=DSoft.System.Mvvm&version=3.0.2110.41-prerelease&prerelease                

System.Mvvm

Model View View Model (MVVM) classes with built in Dependency Injection (DI) for all variants of .NET.

Also provides centralised multi-platform UI Management for WPF (.NET Framework, .NET Core 3.1 and .NET 5.x) and WinUI 3 (Preview 4 and above)(Experimental)

Functionality

  • Implements INotifyPropertyChanged
  • Implements INotifyDataErrorInfo
  • Events for handling and detecting changes
  • Additional properties for
    • IsLoaded
    • IsBusy
    • IsBusyReveresed
    • IsValid
    • IsEditable
    • IsEditableReversed
  • Data Validation
  • Built-In Error notification methods
  • ICommand binding helpers
  • Notification extension actions
    • Rather than overriding a property, add an action when it changes
  • Base View Models for
    • Forms
    • Lists
    • Searchable Lists
    • Tree View Searchable Lists
  • UI
    • Core UI functions for Showing Alerts and Confirmation Dialogs (using platform specific implementations)
      • UWP, WinUI and WPF (.NET Framework and .NET Core 3.1, .NET 5+)

Classes

ViewModel

This is the base View Model abstract class which contains the most common MVVM functionality

ListViewModel<T,T2>

This class inherits from ViewModel and provides additonal functionality for managing lists of data

SearchViewModel<T, T2>

This class inherits from ListViewModel<T,T2> and adds search and filtering functionality to the standard ListViewModel

SearchTreeViewModel<T, T2>

This class inherits from SearchViewModel<T, List<T>> and adds Tree Path preparation to the standard SearchViewModel

Using System.Mvvm

Basic ViewModel

All of the ViewModel base classess are in the System.Mvvm namespace. To create a basic ViewModel simple inherit from ViewModel.

using System.Mvvm;
...
public class MainViewModel : ViewModel
{

To create a notifiable property create a property with a backing field using the propfull snippet and add a call to NotifyPropertyChanged.

private int myVar;

public int MyProperty
{
    get { return myVar; }
    set { myVar = value;  NotifyPropertyChanged();}
}

NotifyPropertyChanged will automatically pickup the calling member, but you can also be explicit.

private int myVar;

public int MyProperty
{
    get { return myVar; }
    set { myVar = value; NotifyPropertyChanged(nameof(MyProperty)); }
}

Using System.Mvvm.Ui

The UI static class provides two features

  • A central interface for calling some simple UI functions
    • ShowAlert(string title, string message)
      • Show an alert with a title and message
    • ShowConfirmation(string title, string message)
      • Show a confirmation dialog and return the result
    • InvokeOnUIThread(Action)
      • Execute the action on the UI thread
    • InvokeOnUIThreadAsync(Action)
      • Execute the action on the UI thread asyncronously

The standard UI functions can be called directly after adding the DSoft.Mvvm.Ui package

using System.Mvvm;
... 

var result = await UI.ShowConfirmationDialogAsync("Confirm this", "This is a platform specific confirmation message");

if (result)
    await UI.ShowAlertAsync("YAY!", "You confirmed that");

NOTE: The standard UI functions only work when the platform code has been registered using MvvmManager.Init on the supported plaforms

MvvmManager

MvvmManager is a class that is found in the Dsoft.System.Mvvm.Ui package and registers the standard UI implementation for UI for each supported platform.

Call MvvmManager.Initto initialise the platform implementation.

NOTE: Only WPF(.NET framework, .NET Core 3.1, .NET 5.x) and WinUI 3 (Preview 4 and above) and UWP are supported with MvvmManager at the moment

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.
  • net5.0

    • No dependencies.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on DSoft.System.Mvvm:

Package Downloads
DSoft.System.Mvvm.Ui

Core UI library for System.Mvvm.UI

DSoft.System.Mvvm.Hosting

Microsoft.Extensions.Hosting helper library and System.Mvvm extensions

DSoft.System.Mvvm.UI.WPF

WPF platform support for DSoft.System.Mvvm.UI for .NET Framework 4.62 AND NET6+

DSoft.System.Mvvm.UI.Forms

Xamarin.Forms platform support for System.Mvvm.UI

DSoft.System.Mvvm.UI.WinUI

WinUI 3 platform support for System.Mvvm.UI for NET6+ and UWP

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.4.2411.191 258 11/19/2024
3.4.2406.251 443 6/25/2024
3.3.2405.241 329 5/24/2024
3.3.2405.21 286 5/5/2024
3.2.2301.91 1,684 1/9/2023
3.1.2208.151 1,954 8/15/2022
3.1.2205.231 2,014 5/23/2022
3.1.2205.52-beta1 622 5/5/2022
3.0.2202.121 1,955 2/12/2022
3.0.2111.271-prerelease 622 11/27/2021
3.0.2110.81-prerelease 361 10/8/2021
3.0.2110.71-prerelease 297 10/7/2021
3.0.2110.61-prerelease 300 10/6/2021
3.0.2110.41-prerelease 344 10/4/2021
2.4.2109.301 2,171 9/30/2021
2.4.2108.41 649 8/5/2021
2.3.2107.201 548 7/20/2021
2.3.2105.221 1,436 5/24/2021
2.3.2105.211-preview2 285 5/21/2021
2.2.2103.241-preview2 267 3/24/2021
2.2.2102.142-prerelease 196 2/14/2021
2.2.2102.141-preview1 203 2/14/2021
2.1.2103.242-preview2 237 3/24/2021
2.1.2102.81 637 2/8/2021
2.0.2011.103 659 11/10/2020
1.3.2010.162-prerelease 297 10/16/2020
1.3.2010.151-prerelease 302 10/15/2020
1.2.2010.151 576 10/15/2020
1.2.2010.121 660 10/12/2020
1.2.2006.221 777 6/22/2020
1.2.2005.121 627 5/12/2020
1.2.2004.202 588 4/20/2020
1.2.2004.91 607 4/9/2020
1.2.2002.171 3,010 2/17/2020
1.2.1911.261 2,600 11/26/2019
1.2.1911.212 600 11/21/2019
1.2.1911.211 502 11/21/2019
1.2.1911.55 535 11/5/2019
1.2.1911.54 517 11/5/2019
1.2.1911.51 540 11/5/2019
1.2.1909.251 581 9/25/2019
1.2.1909.202 1,097 9/20/2019
1.2.1909.201-preview 354 9/20/2019
1.2.1908.819 620 8/8/2019
1.2.1908.817-preview 390 8/8/2019
1.2.0-preview1 411 8/7/2019

- Removed obsolete methods and properties