CSLA 5 releases

CSLA 5 is a big release with some breaking changes, some major enhancements, and with new support for .NET Core 3 and WebAssembly (Blazor, etc.).

CSLA .NET version 5.1.0 release

Enhancements primarily related to Blazor support, along with a few other good changes/fixes.

Change List

Changes in this release.

Highlights:

Blazor

• #1443 Changed Csla.Blazor.PropertyInfo to not be generic
• #1435 Add authorization helpers for Blazor
• #1440 Add ModelPropertyChanged event to ViewModel
• #1410 Add ModelChanged/ModelChanging events to ViewModel
• #1371 Ensure Csla.Blazor works on server-side code too
• #1295 #1309 #1436 Add CslaValidator component for Blazor

Authentication and Authorization

• #1409 Updates to CslaClaimsPrincipal

Razor and MVC

• #1389 Add netcoreapp3.1 project for ASP.NET Core 3.1
• #1368 Add netcoreapp3.0 project for ASP.NET Core 3.0
• #1367 Add Razor tag helpers for validation (error/warn/info) text

Data Portal

• #1459 Fix major perf issues with CSLA 5 data portal
• #1444 DataPortalException now returns better data via ErrorInfo
• #1424 Add ApplicationContextManagerTls type
• #1417 Fix issue with context disappearing after async call
• #1387 Improve exception messages from HttpProxy
• #1386 Auto-create scoped DI service provider on data portal server
• #1332 Factory data portal needs to support DI (via constructor injection)

Templates

• #752 Update NuGet templates package to work in VS 2017, 2019

Analyzers

• #1441 Fix bug with BusinessRuleDoesNotUseAddMethods analyzer
• #1348 Analyzer: Operation attribute usage

Examples

• #1358 Create XamarinExample sample app
• #1364 Create RazorPagesExample sample app

Bug fixes

• #1464 AmbiguousMatchException no longer thrown due to method overrides
• #1400 Fix issue with ApplicationContext and LocalProxy and losing local/global context values
• #1402 Fix issue building CSLA in debug mode
• #1369 Fix issues with ApplicationContext in netcore 3
• #1360 Fix issue with DbContext in .NET Core 3

Dependabot and NuGet dependencies

• Bump Microsoft.Extensions.DependencyInjection to 3.1.1
• Bump Microsoft.Extensions.DependencyInjection.Abstractions to 3.1.1
• Bump Microsoft.AspNetCore.Components.Web from 3.0.0 to 3.1.1
• Bump Microsoft.AspNetCore.Components from 3.0.0 to 3.1.1
• Bump System.Configuration.ConfigurationManager from 4.6.0 to 4.7.0
• Bump System.ComponentModel.Annotations from 4.6.0 to 4.7.0
• Bump System.Security.Permissions from 4.6.0 to 4.7.0
• Bump System.Security.AccessControl from 4.6.0 to 4.7.0
• Bump System.Security.Principal from 4.6.0 to 4.7.0
• Bump System.Data.SqlClient from 4.7.0 to 4.8.0
• Bump Microsoft.Data.SqlClient from 1.0.19249.1 to 1.1.1
• Bump Xamarin.Forms from 4.2.0.815419 to 4.3.0.947036
• Bump Google.Protobuf from 3.9.2 to 3.11.4
• Bump Grpc.Net.Client from 2.24.0 to 2.27.0
• Bump Microsoft.CodeAnalysis.Analyzers from 2.9.4 to 2.9.7

Contributors

• @dazinator lots of help with Blazor implementation
• @TheCakeMonster lots of help with Blazor implementation
• @JasonBock lots of work with the analyzers
• @skeeler88 bug fixes
• @bradtwurst bug fixes
• @jeddytier4 got the NuGet templates package working again
• @j055 helped figure out and fix the local/global context issue
• @Eduardo-Micromust found and fixed numerous method calling issues
• @linkerro fixed some NuGet package reference issues
• @SachinPNikam updated the Blazor samples

CSLA .NET version 5.0.1 release

Bug fix release over 5.0.0.

Change List

• #1336 Target Microsoft.Extensions.* 2.x versions, not 3.0 versions
• #1337 Fix issue with WPF depedendencies in .NET Core 3

CSLA .NET version 5.0.0 release

CSLA 5 is a big release with some breaking changes, some major enhancements, and with new support for .NET Core 3 and WebAssembly (Blazor, etc.).

Change List

This release contains numerous potential breaking changes so please pay attention to the ⚠ (possible) and 🛑 (likely) breaking symbols.

Some changes were made to address common issues people face using CSLA. I've tried to mark these as things to look out for because they'll likely simplify your life: 🎉

NuGet Package Naming

• #1151 Rename NuGet packages to use modern conventions 🛑

ALERT: To use CSLA .NET version 5.0.0 or higher you will need to remove all older NuGet package references and reference the modern equivalents.

Dependabot and NuGet dependencies

• Bump appropriate dependencies for .NET Core 3.0
• Bump Microsoft.AspNetCore from 2.0.3 to 2.2.0 in /Source
• Bump Xamarin.Forms from 3.4.0.1008975 to 4.1.0.815419 in /Source
• Add Microsoft.EntityFrameworkCore from 3.0.0 in /Source
• Bump Microsoft.EntityFrameworkCore from 2.2.0 to 2.2.6 in /Source
• Bump Microsoft.CodeAnalysis.Analyzers from 2.6.3 to 2.9.4 in /Source
• Bump Microsoft.NETCore.UniversalWindowsPlatform to 6.2.9 in /Source
• Bump System.Data.SqlClient to 4.7.0 in /Source
• Bump System.Principal.Windows from 4.5.1 to 4.6.0 in /Source
• Bump System.Security.AccessControl from 4.5.9 to 4.6.0 in /Source

Data Portal

• #1293 Fix issue where ObjectFactory wasn't working correctly with remote data portal
• #1066 Implement RabbitMQ data portal (Csla.Channels.RabbitMq) 🎉
• #1140 Implement gRPC data portal (Csla.Channels.Grpc) 🎉
• #1176 Enable passing multiple parameters to root DP methods (i.e. FetchAsync) 🎉
• #787 Enable per-method dependency injection for DP_XYZ and Child_XYZ method params 🎉
• #1102 Eliminate hard-coded DP_XYZ and Child_XYZ method names 🎉
• #1167 Add UpdateAllChildren method to FieldManager to persist all child objects even if IsDirty is false
• #1164 Fix issue where LocalProxy would lock on async calls from Windows Forms
• #1060 Mark Silverlight-style data portal methods (e.g. BeginFetch, BeginSave) obsolete ⚠
• #1059 HttpProxy now supports both sync and async operations 🎉
• #1072 Fix issue where LocalProxy didn't flow context to async calls as expected
• #1038 Set default transaction timeout to 600 seconds (to match Microsoft default) ⚠
• #960 Make sure only one SaveObject method is virtual ⚠
• #1103 Fix null ref exception when interacting with types that don't implement IDataPortalTarget
• #1152 Fix server response content-length issue with Blazor serialization

Basic Usage

• #1194,#1196 Pass criteria to authorization rules via new IAuthorizationContext interface 🛑
• #1212 Fix issue with n-level undo and cloning
• #1191 Fix edit level issue with business rules
• #1101 Support nameof in RegisterProperty, replacing lambda expressions 🎉
• #409 Allow use of async Task ExecuteAsync business rule implementations via new BusinessRuleAsync type 🎉
• #1043 Default null principal to an unauthenticated principal` (no longer need to manually set principal on app startup) 🎉
• #1080 Fixed issues caused by using MobileFormatter for n-level undo in .NET Framework
• #974 Rename DbProvider config key to CslaDbProvider 🛑
• #963 Mark RelationshipTypes.Child as Obsolete ⚠
• #1117 Fix issue where string properties would ignore explicit null default value
• #1209 Add ObjectAuthorizationRules attribute so AddObjectAuthorizationRules is no longer a "magic name" method 🎉

Analyzers

• #1100 Ensure DP methods return void or Task
• #804 Update analyzers to modern project style and .NET Standard 1.3 (now requires Visual Studio 2017 or higher) ⚠
• #623 Fix issue where analyzer would incorrectly flag an issue with serializable attributes 🎉
• #925 Create analyzer to flag use of new keyword when creating domain objects (require use of data portal)
• #1091 Update/cleanup analyzer code

Blazor and WebAssembly

• #1283 Add Blazor validation component
• #1142 Add UI helper support for client-side Blazor and WebAssembly 🎉
• #1270 Add UnoExample sample

Xamarin

• #1291 Obsolete Save method in favor of SaveAsync 🛑
• #1304 Add properties to get info/warn/error text from PropertyInfo
• #1010 Fix issue where ApplicationContext.User wasn't persisted during async operations
• #1168 Mark old-style viewmodel async methods as obsolete and modernize class overall 🛑

Data Access

• #1138 Fix NETfx-NS2 conflict with TransactionTypes enum
• #1150 Add support for Microsoft.Data.SqlClient via new Csla.Data.SqlClient package 🎉
• #981 Move support for System.Data.SqlClient into new Csla.Data.SqlClient.Fx package - it is no longer in the core of CSLA 🛑

ASP.NET Core

🛑 ASP.NET Core 2.2 projects often rely on the Microsoft.AspNetCore.App metapackage. You can not use this metapackage with CSLA 5, because the metapackage prevents the use of .NET Core 3.0 dependencies. The easiest workaround is to switch to the Microsoft.AspNetCore.All metapackage, though other options exist. 🛑

• #905 Add support for ASP.NET Core MVC validation mechanism
• #649 Implement CSLA permission requirement handler

WPF

• #1291 Obsolete Save method in favor of SaveAsync 🛑
• #1304 Add properties to get info/warn/error text from PropertyInfo
• #1235 Bring Csla.Xaml for WPF forward to .NET Core 3
• #1168 Mark old-style viewmodel async methods as obsolete and modernize class overall 🛑

Windows Forms

• #1234 Bring Csla.Windows forward to .NET Core 3

Technical Debt

• #1288 Updated /Samples for CSLA 5
• #1115 Remove private constructors from templates
• #968 Remove ApplicationContext.IsInRoleProvider property ⚠
• #1053 Update nuspec files to use license element
• #1070 Remove unused legacy Silverlight test code and resolve SonarQube warning
• #1109 Add ContextManager property to CslaConfiguration fluent API
• #1111 Update website URL to https://cslanet.com in source files
• #1119 Update bootstrap version in ProjectTracker to resolve security warning
• #750 Updated editorconfig styles
• #1004 Update use of test database so data tests run on developer workstations

You can see all the closed work items in GitHub.

Contributors

I want to extend special recognition to the following contributors to this release:

• @JasonBock has put a lot of work into the analyzers - fixing long-standing issues, and creating some cool new analyzers as well - really nice!
• @GillesBer ported the Windows Forms and WPF satellite projects for use in .NET Core 3
• @itgoran has been helping ensure the tests all work
• @oatsoda has been fixing some issues encountered in 4.9 - resulting in fixes 5.0
• @Hadronicus similarly has fixed an issue in 4.9 that's in 4.10 and 5.0
• @kellyethridge fixed a LocalProxy issue
• @skalpin helped review/update some of the docs
• @ajj7060 added features to authorization rules
• @dazinator and @ajj7060 have been engaged in identifying issues and solutions
• @j055 for data portal enhancements
• @TheCakeMonster for help building out Blazor support

CSLA .NET version 5.0.1 release

CSLA 5.0.1 is a bug fix release over CSLA 5.0.0.

Change List

• #1336 Target Microsoft.Extensions.* 2.x versions, not 3.0 versions
• #1337 Fix issue with WPF depedendencies in .NET Core 3

CSLA .NET version 5.0.0 release

CSLA 5 is a big release with some breaking changes, some major enhancements, and with new support for .NET Core 3 and WebAssembly (Blazor, etc.).

Change List

This release contains numerous potential breaking changes so please pay attention to the ⚠ (possible) and 🛑 (likely) breaking symbols.

Some changes were made to address common issues people face using CSLA. I've tried to mark these as things to look out for because they'll likely simplify your life: 🎉

NuGet Package Naming

• #1151 Rename NuGet packages to use modern conventions 🛑

ALERT: To use CSLA .NET version 5.0.0 or higher you will need to remove all older NuGet package references and reference the modern equivalents.

Dependabot and NuGet dependencies

• Bump appropriate dependencies for .NET Core 3.0
• Bump Microsoft.AspNetCore from 2.0.3 to 2.2.0 in /Source
• Bump Xamarin.Forms from 3.4.0.1008975 to 4.1.0.815419 in /Source
• Add Microsoft.EntityFrameworkCore from 3.0.0 in /Source
• Bump Microsoft.EntityFrameworkCore from 2.2.0 to 2.2.6 in /Source
• Bump Microsoft.CodeAnalysis.Analyzers from 2.6.3 to 2.9.4 in /Source
• Bump Microsoft.NETCore.UniversalWindowsPlatform to 6.2.9 in /Source
• Bump System.Data.SqlClient to 4.7.0 in /Source
• Bump System.Principal.Windows from 4.5.1 to 4.6.0 in /Source
• Bump System.Security.AccessControl from 4.5.9 to 4.6.0 in /Source

Data Portal

• #1293 Fix issue where ObjectFactory wasn't working correctly with remote data portal
• #1066 Implement RabbitMQ data portal (Csla.Channels.RabbitMq) 🎉
• #1140 Implement gRPC data portal (Csla.Channels.Grpc) 🎉
• #1176 Enable passing multiple parameters to root DP methods (i.e. FetchAsync) 🎉
• #787 Enable per-method dependency injection for DP_XYZ and Child_XYZ method params 🎉
• #1102 Eliminate hard-coded DP_XYZ and Child_XYZ method names 🎉
• #1167 Add UpdateAllChildren method to FieldManager to persist all child objects even if IsDirty is false
• #1164 Fix issue where LocalProxy would lock on async calls from Windows Forms
• #1060 Mark Silverlight-style data portal methods (e.g. BeginFetch, BeginSave) obsolete ⚠
• #1059 HttpProxy now supports both sync and async operations 🎉
• #1072 Fix issue where LocalProxy didn't flow context to async calls as expected
• #1038 Set default transaction timeout to 600 seconds (to match Microsoft default) ⚠
• #960 Make sure only one SaveObject method is virtual ⚠
• #1103 Fix null ref exception when interacting with types that don't implement IDataPortalTarget
• #1152 Fix server response content-length issue with Blazor serialization

Basic Usage

• #1194,#1196 Pass criteria to authorization rules via new IAuthorizationContext interface 🛑
• #1212 Fix issue with n-level undo and cloning
• #1191 Fix edit level issue with business rules
• #1101 Support nameof in RegisterProperty, replacing lambda expressions 🎉
• #409 Allow use of async Task ExecuteAsync business rule implementations via new BusinessRuleAsync type 🎉
• #1043 Default null principal to an unauthenticated principal` (no longer need to manually set principal on app startup) 🎉
• #1080 Fixed issues caused by using MobileFormatter for n-level undo in .NET Framework
• #974 Rename DbProvider config key to CslaDbProvider 🛑
• #963 Mark RelationshipTypes.Child as Obsolete ⚠
• #1117 Fix issue where string properties would ignore explicit null default value
• #1209 Add ObjectAuthorizationRules attribute so AddObjectAuthorizationRules is no longer a "magic name" method 🎉

Analyzers

• #1100 Ensure DP methods return void or Task
• #804 Update analyzers to modern project style and .NET Standard 1.3 (now requires Visual Studio 2017 or higher) ⚠
• #623 Fix issue where analyzer would incorrectly flag an issue with serializable attributes 🎉
• #925 Create analyzer to flag use of new keyword when creating domain objects (require use of data portal)
• #1091 Update/cleanup analyzer code

Blazor and WebAssembly

• #1283 Add Blazor validation component
• #1142 Add UI helper support for client-side Blazor and WebAssembly 🎉
• #1270 Add UnoExample sample

Xamarin

• #1291 Obsolete Save method in favor of SaveAsync 🛑
• #1304 Add properties to get info/warn/error text from PropertyInfo
• #1010 Fix issue where ApplicationContext.User wasn't persisted during async operations
• #1168 Mark old-style viewmodel async methods as obsolete and modernize class overall 🛑

Data Access

• #1138 Fix NETfx-NS2 conflict with TransactionTypes enum
• #1150 Add support for Microsoft.Data.SqlClient via new Csla.Data.SqlClient package 🎉
• #981 Move support for System.Data.SqlClient into new Csla.Data.SqlClient.Fx package - it is no longer in the core of CSLA 🛑

ASP.NET Core

🛑 ASP.NET Core 2.2 projects often rely on the Microsoft.AspNetCore.App metapackage. You can not use this metapackage with CSLA 5, because the metapackage prevents the use of .NET Core 3.0 dependencies. The easiest workaround is to switch to the Microsoft.AspNetCore.All metapackage, though other options exist. 🛑

• #905 Add support for ASP.NET Core MVC validation mechanism
• #649 Implement CSLA permission requirement handler

WPF

• #1291 Obsolete Save method in favor of SaveAsync 🛑
• #1304 Add properties to get info/warn/error text from PropertyInfo
• #1235 Bring Csla.Xaml for WPF forward to .NET Core 3
• #1168 Mark old-style viewmodel async methods as obsolete and modernize class overall 🛑

Windows Forms

• #1234 Bring Csla.Windows forward to .NET Core 3

Technical Debt

• #1288 Updated /Samples for CSLA 5
• #1115 Remove private constructors from templates
• #968 Remove ApplicationContext.IsInRoleProvider property ⚠
• #1053 Update nuspec files to use license element
• #1070 Remove unused legacy Silverlight test code and resolve SonarQube warning
• #1109 Add ContextManager property to CslaConfiguration fluent API
• #1111 Update website URL to https://cslanet.com in source files
• #1119 Update bootstrap version in ProjectTracker to resolve security warning
• #750 Updated editorconfig styles
• #1004 Update use of test database so data tests run on developer workstations

You can see all the closed work items in GitHub.

Contributors

I want to extend special recognition to the following contributors to this release:

• @JasonBock has put a lot of work into the analyzers - fixing long-standing issues, and creating some cool new analyzers as well - really nice!
• @GillesBer ported the Windows Forms and WPF satellite projects for use in .NET Core 3
• @itgoran has been helping ensure the tests all work
• @oatsoda has been fixing some issues encountered in 4.9 - resulting in fixes 5.0
• @Hadronicus similarly has fixed an issue in 4.9 that's in 4.10 and 5.0
• @kellyethridge fixed a LocalProxy issue
• @skalpin helped review/update some of the docs
• @ajj7060 added features to authorization rules
• @dazinator and @ajj7060 have been engaged in identifying issues and solutions
• @j055 for data portal enhancements
• @TheCakeMonster for help building out Blazor support

I am pleased to announce the release of CSLA .NET version 4.11.2.

This is a bug fix release from 4.11.1.

• #1212 Fix issue with n-level undo and cloning

CSLA .NET version 4.11.1 Release Notes

I am pleased to announce the release of CSLA .NET version 4.11.1.

This is a bug fix release from 4.11.0.

• #1138 Backport fix for TransactionTypes enum issue

CSLA .NET version 4.11.0 Release Notes

I am pleased to announce the release of CSLA .NET version 4.11.0.

This is an enhancement and bug fix release from 4.10.1.

• #1164 Fix issue where LocalProxy would lock a Windows Forms app using async data portal calls
• #1167 Add UpdateAllChildren method to FieldManager to simplify saving all child objects regardless of their IsDirty value

CSLA .NET version 4.10.1 Release Notes

I am pleased to announce the release of CSLA .NET version 4.10.1.

This is a bug fix release from 4.10.0.

• #1130 Backport SimpleDataPortal async mismatch check fix #1117 and fix for explicit null default values for string properties to version 4.x #1103
• #1155 Backport fix for Blazor scenario with HttpProxy to autoflush text writer

CSLA .NET version 4.10.0 Release Notes

I am pleased to announce the release of CSLA .NET version 4.10.0.

This is a bug fix release from 4.9.0.

• #1084 Backport sync context changes from v5.0

CSLA .NET version 4.9.0 Release Notes

The major enhancements are described in some detail in a CSLA .NET 4.9.0 blog post.

Dependabot and NuGet dependencies

We've started using Dependabot to help keep NuGet dependencies current. As a result, the following updates are included in this release:

• Bump Microsoft.AspNet.Razor from 2.0.20710 to 2.0.30506 in /Source
• Bump Microsoft.EntityFrameworkCore from 2.1.4 to 2.2.0 in /Source
• Bump System.Data.SqlClient from 4.5.1 to 4.6.0 in /Source
• Bump Xamarin.Forms from 3.0.0.482510 to 3.4.0.1008975 in /Source
• Bump Microsoft.EntityFrameworkCore from 2.0.2 to 2.1.4 in /Source
• Bump System.Security.Principal.Windows from 4.5.0 to 4.5.1 in /Source
• Bump System.Data.SqlClient from 4.4.3 to 4.5.1 in /Source
• Bump Microsoft.AspNetCore from 2.0.2 to 2.1.6 in /Source
• Bump Microsoft.AspNet.WebPages from 2.0.20710 to 3.2.7 in /Source
• Bump System.ComponentModel.Annotations from 4.4.1 to 4.5.0 in /Source
• [Security] Bump Microsoft.NETCore.UniversalWindowsPlatform

Docs and wiki

We've updated some of the docs and officially removed the wiki. All the wiki/docs content is now in the /docs directory.

Data portal enhancements

• #993 Implement SaveAndMergeAsync methods
• #972 Implement data portal router
• #959 Enhance data portal to use different endpoint per business type
• #961 Create data portal health/instrumentation endpoint
• #1011 Implement IsOffline property for data portal
• #982 Add new IDataPortalFactory singleton for page injection in ASP.NET Core

Configuration enhancements

• #966 Add fluent config types to CSLA: Csla.Configuration.CslaConfiguration
• #967 Read CSLA config values from .NET Core config subsystem: CslaConfigurationOptions
• #1012 Implement ConfigureCsla extension method to IConfiguration for use in .NET Core configuration
• #982 Implement AddCsla method for use in ASP.NET Core ConfigureServices

Bug fixes

• #949 [samples] Fix WinForms and WPF DataPortal configuration to use Azure
• #956 [bug] Check for null User in authz rules
• #962 [bug] Object not serializable (Csla.Core.ContextDictionary) after compiled with .Net Native tool chain and Optimize Code Enabled

You can see all the closed work items in GitHub.