Adding Kentico controls to the Visual Studio toolbox

Before you start using Kentico Controls in your project, it is recommended to add the controls to the Toolbox in Visual Studio:

  1. Open your Kentico web project in Visual Studio. Use the WebSite.sln or WebApp.sln file in the website installation directory ( c:\inetpub\wwwroot\Kentico by default).
  2. Edit any ASPX web form file, for example Default.aspx under the project root. This is necessary, because the toolbox only offers the controls when working with ASPX markup.
  3. Right-click the Toolbox and choose Add Tab.
  4. Type the name of the new tab (for example Kentico) and press Enter.
  5. Right-click the new tab and select Choose Items.
  6. Click Browse on the .NET Framework Components tab of the Choose Toolbox Items dialog.
  7. Navigate to the CMS\bin folder under your website.
  8. Select the CMS.DocumentEngine.Web.UI.dll library.
  9. Click Open and then OK.

The controls are now added to the Toolbox. You can drag the controls into the content of your web forms or user controls.

Apart from controls in the CMS.DocumentEngine.Web.UI.dll library, Kentico offers additional controls contained in libraries with the .Web.UI suffix. For example, the BizForm control can be found in the CMS.OnlineForms.Web.UI.dll assembly, the NewsletterSelector is located in the CMS.Newsletters.Web.UI assembly, etc.