HomeActive Query Builder - IntroductionIntroduction to the version 2.0Upgrading from the previous major version

2.2. Upgrading from the previous major version

Installation of the Active Query Builder 2 .NET Edition does not affect on the installation of the previous major version, so they can be installed simultaneously.

To migrate your project to the Active Query Builder 2 .NET Edition you should remove the reference to the old assemblies and add the appropriate assemblies of the new version. The "2" suffix was added to the names of all assemblies, but the namespace (ActiveDatabaseSoftware.ActiveQueryBuilder) remains the same.

After that you should change the source code of your project according to changes in the new version. There are two main changes that require changes in the source code:

1. QueryBuilder properties are reorganized into several options groups. You can read more about the QueryBuilder property groups here.

We've made the Form Designer conversion command line utility that can help you to replace old properties and events in your .designer.cs and .designer.vb files. You can find the FormDesignerConverter.exe file in the installation directory. Pass the directory to recursively scan for .designer files or the file name as the first parameter. The "AQB Form Designer conversion log.txt" file will be saved to the current directory or to the Documents directory. Backup copies of modified files will be saved to the same directory with the .bak extension.

2. QueryBuilder.MetadataContainer object is re-worked completely. You can read about the new Metadata Container here. If you did not do any customizations in the metadata, you'll need just to replace the call to the QueryBuilder.RefreshMetadata() method with the QueryBuilder.InitializeDatabaseSchemaTree() method.

We've made the Metadata XML file conversion command line utility to convert XML files with metadata from the old to new format. You can find the XmlConverter.exe file in the installation directory. Pass the filename of the old XML file with metadata as the first parameter and the filename to save new XML file as the second parameter.

This page was: Helpful | Not Helpful