Provide an approach to take to replace the classic controls such as UltraWebGrid with the WebDataGrid or WebHierarchicalDataGrid in an existing application. These steps could be applied to replace any of the retired controls and the UltraWebGrid and WebDataGrid are used as examples as they are complex controls that will take longer to replace than the other controls. For a full list of controls that are retired and may need to be replaced in your application refer to the ASP.NET AJAX Control Replacements for Classic Controls.
To begin using the WebDataGrid (or other ASP.NET AJAX Controls) it is first necessary to set up the references to your project so that you can use the current volume of the WebDataGrid in your application. In the simplest scenario you can just add the Infragistics45.Web.v23.1 assembly and the dependent documents assemblies to your application and start using the control. To do this add the following references:
Infragistics45.Web.v23.1
Infragistics45.WebUI.Documents.Word.v23.1
Infragistics45.WebUI.Documents.Core.v23.1
Infragistics45.WebUI.Documents.IO.v23.1
Infragistics45.WebUI.Documents.Reports.v23.1
Infragistics45.WebUI.Documents.Excel.v23.1
Note that if you were referencing an earlier version of any of these assemblies you should be replacing that reference rather than just adding a new reference.
If at this point in time your application builds and runs without issue, you may start using the WebDataGrid in your application to replace the UltraWebGrid.
If your application doesn’t build or doesn’t run correctly, please continue with the rest of this topic to see how to address the most common scenarios.
There are a few options that you can use to address this:
Remove the exporters and plan to add the export functionality back after replacing the relevant UltraWebGrid with a WebDataGrid or WebHierarchicalDataGrid.
Compile the source code for exporter assembly you are using so that it is referencing the current version of the Infragistics.Documents.Excel or Infragistics.Documents.Reports assemblies.
As most of these controls references the Infragistics.Shared assembly like the UltraWebGrid (or other retired control) does, it will be necessary to update all assemblies to the current volume. For the assemblies that are still included in the toolset, simply change the reference. For the assemblies for the retired controls like the UltraWebGrid it will be necessary to compile the source code for these against the shared assembly in the current volume of the toolset.
Note: The recommended approach is to replace all retired controls before upgrading these controls if possible as that approach is simpler.
These are different controls and as such it is best to start with how to best accomplish the desired behavior in the new control and then evaluate how much existing code can be reused. If you start with attempting to reuse all of your code, you may be adding more complexity than needed to using the replacement control. This is especially true for the more complex controls like the WebDataGrid and WebHierarchicalDataGrid as there are more architectural differences and for those you should also read the Migrating from UltraWebGrid to WebDataGrid and WebHierarchicalDataGrid topic for more details.