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.
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).
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.
Use a different method to obtain an instance of the server-side object. The SessionStore.Current reference does not longer exist. The new QueryBuilderStore and QueryTransformerStore static classes provide methods to get the needed objects:
queryBuilder = QueryBuilderStore.Create() // create queryBuilder = QueryBuilderStore.Get() // get saved instance
queryTransformer = QueryTransformerStore.Create() // create
queryTransformer = QueryTransformerStore.Get() // get saved instance
Global configuration settings must be specified in the 'Web.config' file according to the Configuration file Setup Guide.
The MultipleQueriesPerSession property doesn't need anymore. You can instruct to create a new instance of the QueryBuilder object for different query windows by passing unique names to the QueryBuilderStore Create and Get methods.
queryBuilder = QueryBuilderStore.Create("id") // create named instance queryBuilder = QueryBuilderStore.Get("id") // get named instance
queryTransformer = QueryTransformerStore.Create("id") // create named instance
queryTransformer = QueryTransformerStore.Get("id") // get named instance
Note: This feature is available in the Professional version only.
The internal reorganization of assemblies and core objects is described in the common Active Query Builder for .NET 3 Migration guide.
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.