Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

We strive to ensure that the CSLA templates are backwards compatible with previous versions. However, in some circumstances we break backwards compatibility to progress the platform. When we do break backwards compatibility, we ensure that the benefits of breaking compatibility greatly outway the benefits of not breaking compatibility. Please refer to this document when upgrading the CSLA Templates to ensure that you have the smoothest experience possible.

...

Info
Please follow the guides for downloading and installing the CSLA Templates before continuing.

...

Info
If you are Installing a new version of Visual Studio, you must rerun the CodeSmith Generator installer to ensure Visual Studio Integration is installed.

...

The next step is to regenerate the solution. You can do this by right clicking the Generator Project and selecting build. Next, check for template compile and generation errors in the output window.

  • If you see any errors about template file not found, then you will need to go to the previous step and ensure that the template output mentioned has the correct propertySet template node path.
  • If you are seeing an error that deals with a template property not being able to be set. Please check the release notes , to see if a property has been removed. If it has , or you are getting an error, you can follow the previous step, but remove the property XML node in question and repopulate it via Manage Outputs. This is very rare if you do encounter this issue.
  • Unable If you are unable to compile or generate template. Please the template, please contact support with the full stack trace / output window and we will take a look into the issue.

...

  • upgrading from a minor version of CSLA (EG., 4.1 to 4.2), then chances are you are running into a bug with the templates. Please contact support and we will get this taken care of.
  • upgrading to a major versions of CSLA (EG., 3.x to 4.x), then please check the release notes or upgrade documentation below.

...

It is highly recommended that you read over the official CSLA Documentation when upgrading between versions of CSLAThis ensures that you are aware of all of the changes that will occur in your application.

...

Before you continue this step, please ensure that you have followed the previous upgrade guide and have regeneratedhave regenerated. You will notice that there are some build errors.  This is due to the entity partial classes are not regenerated classes not being regenerated and there are some required changes for Rules or for Silverlight when migrating to CSLA 4.x.

...

There were major changes to Rules in CSLA 4.0. You will need to update every business objects object's non generated partial class (E.G., Account.cs or Account.vb).

...

C#Visual Basic
Update existing method signatures from (as well as existing rule logic inside of the method):
Code Block
languagecsharp
protected override void AddAuthorizationRules()
Code Block
languagevb
Protected Overrides Sub AddAuthorizationRules()
To:
Code Block
languagecsharp
public static void AddObjectAuthorizationRules()
Code Block
languagevb
Protected Shared Sub AddObjectAuthorizationRules()

...