When you install a new version of .NET controls, assembly references for projects that you developed under the previous version become out of date. If you want these projects to use the newer controls, you must update the references. You use the Update Assembly References tool for this purpose.

You can launch the Update Assembly References tool from Progress Developer Studio for OpenEdge, but the tool actually runs outside the Eclipse framework. This topic provides basic instructions for using the tool; you can access more detailed online help when the tool is running.

It is possible to use multiple versions of controls concurrently. However, the Progress Developer Studio for OpenEdge Visual Designer Toolbox can contain only one version of each control.

When to update assembly references

You should complete the update procedure each time you install a new version of any control set. This recommendation applies whether you install a new release of OpenEdge that includes upgraded controls, a patch from Progress Software Corporation that includes upgraded controls, or a control set that you obtain from any other source. Failure to update assembly references may prevent existing OpenEdge GUI for .NET forms from running, and may also prevent the Progress Developer Studio for OpenEdge Visual Designer from opening existing forms or from functioning properly when you try to develop new forms.

It is not necessary to update assemblies after applying a hot fix from Progress Software Corporation.

Note: It is not necessary to update assemblies after applying a hotfix from Progress Software Corporation.

Automatic update of Progress assembly references

When using Progress Developer Studio for OpenEdge, the first time you open a workspace that includes one or more projects with out-of-date assembly references, a dialog alerts you to the situation and asks whether you want to update the references. If you click Yes at this dialog, OpenEdge automatically updates all references to Progress assemblies, including those containing OpenEdge Ultra Controls (Infragistics controls).

If you decline this automatic update, you will not be prompted again to update the current workspace. You should manually run the Update Assembly References tool when you are ready to perform the update.

The automatic update procedure does not affect third-party (non-Progress) assemblies. Run the Update Assembly References tool when you install a new version of any third-party controls.