Troubleshoot Toolbox Items in Visual Studio - DevExpress Unified Component Installer

• Sep 15, 2024
• 5 minutes to read

DevExpress Unified Component Installer integrates DevExpress products into your Visual Studio instance. Most DevExpress products for the .NET Framework (WinForms, ASP.NET WebForms, WPF controls, XAF components) are available in the Visual Studio Toolbox.

Display WinForms and WPF Controls in Toolbox (.NET 6+)

If you add DevExpress products and use a NuGet feed instead of the Unified Component Installer, the toolbox does not contain DevExpress UI controls until you add the corresponding NuGet packages. Do the following:

1. Go to Tools | NuGet Package Manager | Manage NuGet Packages for Solution and add NuGet packages that contain required controls to make these controls available in the Visual Studio Toolbox.

2. Enable the Automatically Populate Toolbox setting in Visual Studio (“Tools | Options | Windows Forms Designer | General”).

3. Restart Visual Studio.

Resolve Issues with Toolbox Items (.NET Framework)

This section explains how to resolve the following issues with Toolbox items:

• The Toolbox does not display items for DevExpress products.
• Visual Studio takes a long time to load the Toolbox.
• The Toolbox duplicates items for DevExpress products.

Note

In most cases, uninstalling DevExpress products and reinstalling them helps to resolve toolbox-related issues.

Please note that after reinstalling DevExpress components and opening Toolbox for the first time, setting it up may take a significant amount of time (especially if you have an older version of Visual Studio and more than two DevExpress versions installed). Visual Studio may appear to be hanging, but it is setting up a set of tools. Do not close Visual Studio. Otherwise, the Toolbox will not be configured correctly.

1. Make sure that you installed the required product on your machine.

2. Ensure that you set the correct Target Framework for your project.

3. Diagnose and reinitialize the Visual Studio Toolbox.

4. Send log files to DevExpress Support Team.

Completely Reset the Toolbox and Enable Visual Studio to Rebuild it From Scratch

After you install or update DevExpress products, you may experience issues with Toolbox items. Follow the steps below to reset the Toolbox from Visual Studio:

1. Right-click the Toolbox.
2. Click Reset Toolbox….

After resetting the toolbox, follow these steps (depending on your version of Visual Studio):

Visual Studio 2017 and Newer

1. Close Visual Studio.
2. Open the “%LocalAppData%\Microsoft\VisualStudio*<version>* _ <instance-id> “ folder and remove all the .TBD files.
3. Run the “regedit” tool (Regedit.exe). To do this, click the “Run” item in the Start menu and type “regedit” without quotation marks.
4. Load Visual Studio’s private registry as described in the following article in the Microsoft documentation: How to examine Visual Studio 2017 registry.
5. Find the “IsolatedHive\Software\Microsoft\VisualStudio\<version>_<instance-id>\ToolboxControlsInstaller_AssemblyFoldersExCache” and “IsolatedHive\Software\Microsoft\VisualStudio\<version>_<instance-id>\ToolboxControlsInstallerCache” keys;
6. Remove everything from these keys leaving them empty.
7. Unload the Visual Studio isolated hive.
8. Run Visual Studio again and wait until it recreates all items in the Toolbox.

If toolbox items are still missing after you perform these steps, delete the %LocalAppData%\Microsoft\VisualStudio\<version> _ <instance-id> folder to fully reset your Visual Studio settings.

Visual Studio 2015 and Older

1. Close Visual Studio.
2. Open the “%LocalAppData%\Microsoft\VisualStudio\10.0” (Windows 7+) folder and remove all .TBD files.
3. Run the “regedit” tool. For this, click the “Run” item in the Start menu and type “regedit” without quotation marks.
4. Find the “HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\ToolboxControlsInstaller_AssemblyFoldersExCache” and “HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\ToolboxControlsInstallerCache” keys.
5. Remove everything from these keys, leaving them empty.
6. Run Visual Studio and wait until it recreates all items in the Toolbox.

Add DevExpress Components to Visual Studio Toolbox Manually

1. Create a new DevExpress toolbox tab.

2. Right-click within the DevExpress tab to invoke the context menu and select Choose Items….

3. Check required DevExpress UI controls:

4. Check required DevExpress UI controls and click OK.

Tip

If you have problems with the Toolbox connected with the Visual Studio Report Designer, refer to the following topic: Visual Studio Report Designer - Troubleshooting.