If you have recently installed the Atalasoft SDK and the controls are not
showing in your Visual Studio toolbox, we can assist you in solving this.
Please note that the older "Client Profile" versions of .NET Framework as well as modern UWP and .NET Core (.NET Core 3.1 / .NET 5/6) are not supported.
So first and foremost, you want to be targeting Windows Forms Application (.NET Framework)
DotImage has legacy web controls but these are being phased out and should not be used for new web projects - so if you came here looking for help on getting toolbox items for Web Forms apps, please note that this is a deprecated/legacy feature that should not be used - instead, please head over to
INFO: WebDocumentViewer Whitepaper - Getting Started With Web Viewing and use the modern WebDocumentViewer instead.
DotImage registers toolbox items in whatever Visual Studio versions are currently installed at install time. Sometimes it's just a matter of
installing/updating to the latest version of DotImage.
If that resolves the issue, yay! If not, the next step is to try manually
adding the controls to your toolbox.
Manually Adding Toolbox Items
Open / start a new Windows Forms project for either C# or VB.NET
Make sure if you're on newer visual studio versions, that you explicitly are choosing Windows Forms Application (.NET Framework) as the somewhat confusing naming for modern MS development may lead you to accidentally choose .NET Windows Forms Application, which is (in newer versions) actually .NET Core and not compatible with DotImage (at this time)
For Visual Studio 2019 and older, make sure you set your application's platform target to x86, for VS2022 and newer, set it to x64.
You can do this by right clicking on your project in Solution Explorer and selecting Properties, Then go to the Build tab (C#) or Compile tab (VB), and set the appropriate "bitness" for Platform Target
Next, make sure the form designer tab is visible (toolbox will not populate if it's not) and have a look at your toolbox. If there's an Atalasoft tab there, you may be all set.
If there's not, or if the Atalasoft tab is empty, then move on to next steps
If it's not there, create a new tab called Atalasoft
Right click on that tab and select the Choose Items option
The Choose Items dialog will take some time to populate, you want the .NET Components tab which should be the default on opening
Once it's done populating, you may want to widen the dialog a bit to make the next steps easier
Click on the Directory column so that it sorts by directory, and look to see if there's directories starting with
C:\Program Files (x86)\Atalasoft\ ...
If so, then look carefully at the rest of the path.. it will follow the pattern
... \DotImage 11.3\bin\3.5\x86\
... \DotImage 11.3\bin\3.5\x64\
... \DotImage 11.3\bin\4.5.2\x86\
... \DotImage 11.3\bin\4.5.2\x64\
If you do not see any such directories listed then you can click the Browse button
What you want to do here is browse to the correct path depending on specifics.. if you're using VS2019 or older you want either
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\3.5\x86\
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\4.5.2\x86\
Which one depends entirely on which .NET Framework you're targeting - the 3.5 path is only if you're targeting .NET framework 3.5. Otherwise, you want the 4.5.2 path to target .NET Framework 4.5.2. or up (up to 4.8). NOTE we do not support .NET Core 3.1 or .NET 5 or .NET 6 at this time
Select that path and then within that find the
Select that and hit Open
When you go back to the dialog you should now have multiple Atalasoft toolbox items among your choices. Select those and Click the OK button
NOTE if the list already has items pay EXTRA CAREFUL ATTENTION to the path - you want to ONLY add items for the framework and bitness you're targeting - otherwise you'll fill your toolbox with incorrectly targeted duplicates and it will be a bit of a mess to decide which one
If you're supporting multiple different versions of DotImage consider making separate tab for each version such as Atalasoft 11.3 and Atalasoft 11.4 as separate items to avoid confusion
Visual Studio 2022 and Newer
Visual Studio 2022 represents an important change in the Visual Studio line. Up until this version, every past Visual Studio edition has been a 32 bit (x86) application. Starting with VS2022, it is now a 64 bit app. This has important ramifications.
For toolbox items and Visual Studio designer it means you need to now be targeting x64 in your winforms apps for the designer to work and for your app to debug correctly in Visual Studio. For previous versions, you would need to taret x86 and reference our x86 dlls.
So, just make sure you translate any instructions in this article to reference x64 and use the dlls from
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\4.5.2\x64\
C:\Program Files (x86)\Atalasoft\DotImage 11.3\bin\3.5\x64
Client Profile Versions Not Supported
Side note for those using older Visual Studio where this applies: Please
ensure you are targeting .NET Framework 3.5 or .NET Framework 4.5.2
through 4.8. In C# it is under your project properties, in the
"Application" tab. There is a drop down titled "Target framework:",
also, make sure it
doesn't have "Client Profile" in the name. If it does, change it to the
equivalent .Net target without "Client Profile" and the controls should
if they were registered on installation.
Q10352 - INFO: Solutions for missing Atalasoft controls from within Visual Studio toolbox