The following are the main points you should pay attention to when migrating from previous versions of Active Query Builder ASP.NET Edition to the third version.

1. HTTP handlers and route config are defined automatically now. Please remove these settings from the 'web.config' file (but there is a way to disable automatic route registration).

2. No need to host CSS, javascript, or image files on your web server. All necessary resources are requested now from AQB handlers.

3. The initialization code and referred assemblies must be updated:

   for WebForms: The component should be initialized in the Page_Load handler, no need for the Init event handler. See the WebForms Quick Start Guide for details.

   for MVC: The component should be initialized in the controller method, no need for the special initialization attribute. See the MVC Quick Start Guide for details.

4. Use a different method to obtain an instance of the server-side object. The SessionStore.Current reference does not longer exists. The new QueryBuilderStore and QueryTransformerStore static classes provide methods to get the needed objects:

   queryBuilder = QueryBuilderStore.GetOrCreate(InitializeQueryBuilder) // create new or get the saved instance 
   queryTransformer = QueryTransformerStore.GetOrCreate(InitializeQueryTransformer) // create new or get the saved instance 

5. Global configuration settings must be specified in the 'Web.config' file according to the Configuration file Setup Guide.

6. The MultipleQueriesPerSession property doesn't need anymore. You can instruct to create a new instance of the QueryBuilder object for different query windows passing unique names to the QueryBuilderStore Create and Get methods. 

   queryBuilder = QueryBuilderStore.GetOrCreate("id", InitializeQueryBuilder) // create new or get the saved named instance
   queryTransformer = QueryTransformerStore.GetOrCreate("id", InitializeQueryTransformer) // create new or get the saved named instance 

   Note: This feature is available in the Professional version only.

7. The internal reorganization of assemblies and core objects is described in the common Active Query Builder for .NET 3 Migration guide.

8. The new client-side Javascript rendering mode available. See the Javascript rendering Quick Start Guide for details.

The full API reference of the Active Query Builder ASP.NET Edition is available here: Active Query Builder ASP.NET Documentation.

Have questions or comments? Feel free to post them below.