2016

Telerik Instalación
Winforms

PASOS PARA INSTALAR

ESTRADA, ABRAHAN

CANELLA | 2016
Contenido
Deployment Strategies.................................................................................................................. 10
X-Copy ..................................................................................................................................... 10
GAC .......................................................................................................................................... 11
ClickOnce ................................................................................................................................. 11
Running an Application from a Network Drive ........................................................................ 11
Assemblies that you should redistribute in all scenarios .......................................................... 11
Assemblies that you should redistribute if using Telerik Analytics ......................................... 11
Assemblies that you need to redistribute depending on which controls you use in your
application........................................................................................................................................ 11
Using the Visual Studio menus ...................................................................................................... 14
Using the the drag-drop approach .................................................................................................. 14
Troubleshooting.............................................................................................................................. 15
Telerik assemblies do not appear in Visual Studio's Add reference dialog .............................. 15
Telerik assemblies do not appear in Visual Studio's Add reference dialog although they are
added in the GAC ...................................................................................................................... 15
Repetitive RadControls entries in the Toolbox ......................................................................... 16
Adding controls to GAC by using the gacutil tool (Windows XP, Vista, Win7) ........................... 16
Removing assemblies by using the gacutil tool (Windows XP, Vista, Win7) ............................... 17
Adding and removing controls to GAC manually (Vista, Win7) ................................................... 17
Examples of Permitted Uses ........................................................................................................... 19
Examples of Uses that Require Telerik review .............................................................................. 19
ILMerge Telerik WinForms assemblies ......................................................................................... 19
Building the Telerik assembles from source code - using the OemAssemblyName ...................... 21
Building the Telerik assembles from source code - using the OemPublicKeyToken .................... 24
Using the Telerik Document Processing libraries in Your Solutions ............................................. 30
Using the images from the suite in your solutions ......................................................................... 31
Telerik UI for WinForms Assemblies ............................................................................................ 31
Significance of the Design Assembly ............................................................................................ 38
Actions taken during the Telerik UI for WinForms Setup ............................................................ 39
Actions taken by the Telerik Visual Studio Extensions Wizards .................................................. 39
Location of Telerik.WinControls.UI.Design assembly ................................................................. 39
Project setup.................................................................................................................................. 40
Project Upgrade Notifications for Detected Local Distributions ............................................. 41
Other Notifications ....................................................................................................................... 41
Select a folder for downloads ....................................................................................................... 41
Latest version retrieval ................................................................................................................ 41
Notifications .................................................................................................................................. 42
Installation, Deployment and Distribution Telerik UI for WinForms

Telerik UI for WinForms

Installing On Your Computer
Send Feedback

The Telerik WinForms setup performs the following actions during the installation process:
 Copies the needed files and assemblies on your machine
 Installs all Telerik WinForms assemblies in the Global Assembly Cache (GAC)
 Creates native images for all Telerik UI for WinForms assemblies
 Checks the Visual Studio version(s) installed on the machine. We currently support Visual Studio 2005, 2008,
2010, 2012 and 2013 installations
 Installs/adds all Telerik WinForms controls in the toolbox of Visual Studio
 Installs Telerik UI for WinForms Visual Studio templates
 Installs Telerik UI for WinForms Visual Studio Extensions add-on
 Installs Telerik UI for WinForms Examples
 Installs Telerik UI for WinForms Coded UI support for Visual Studio 2010 and 2012
Please follow the steps below to install Telerik UI for WinForms:
1. Close all running instances of Visual Studio.
2. Run the Telerik UI for WinForms setup as Administrator (right-click on the installer and select Run As
Administrator).
3. The installer will display the Welcome screen. Click Next to continue.
You can use the Read License Agreement button to display the license agreement. Review the License Agreement
carefully as it contains important information about the tools, the source code, and support. Click OK afterwards, or
use the Print button to print the agreement. Once you are done, select the I agree - Continue in order to continue.
4. In this step the installer checks the Visual Studio and .NET versions that are installed on the machine in order to
prepare the files for installation.
5. You can use the Customize button to choose which features will be installed and the installation path.
6. Once done with the installation customization click the Install to start the installation process.
7. The installer will install the controls and display its progress as it does so. You may click Cancel to reverse the
process while this screen is displayed.
8. The installer will display the completion screen when the controls are installed. Select the Launch Examples check
box to launch the examples when the installer is closed. Click Finish to complete the installation.
Send comments on this topic to documentation@telerik.com

Telerik UI for WinForms

Application Deployment
Send Feedback

When you use Telerik controls in your WinForms application, your application must have references to several of Telerik
assemblies. These references are automatically added to your project when you drag and drop controls or component on
your form. There are three assemblies required in general and the rest are added only if you are using a specific control
that requires some other assembly. In sum, most of the time you will not have to add references to all Telerik assemblies.
Also in general, the assembly references will be added automatically and they will refer to the assemblies installed in the
GAC by Telerik WinForms installer.
Note
RadMarkupEditor and RadMarkupDialog require a reference to Microsoft.mshtml assembly and if you need to use them at Run Time
you will need to distribute this assembly to the end user computers as well. You can find further information about that in
this external resource:
http://msdn.microsoft.com/en-us/library/w0dt2w20.aspx
You do not need to do anything on your developer machine, because Visual Studio provides the required assembly. Also if your
application does not use the editor or the dialog, you do not need a reference to this assembly.
Deployment Strategies
X-Copy
This is the simplest strategy. For each Telerik assembly reference in the Solution Explorer, open its context menu, click on
properties and in the property grid set the Copy Local property of the reference to True.
 Thus these Telerik assemblies will be copied to your Release/Bin, Debug/Bin folders. You application deployment
consists of copying the exe, dlls, xmls files to your client machines which in the simpler case will be manual copy and in
the more advanced scenario will be a copy by your installer.

GAC
As noted above, Telerik assemblies are installed in the GAC by Telerik installer on the developer machines. You may
choose to insert Telerik assemblies in the GAC of your client machines too by following the instructions in
the Add/Remove RadControls to the Global Assembly Cache (GAC) section.
Note
Please do not use Telerik installer to install Telerik assemblies in the GACs of your clients' machines. Telerik installer should be used
only for the developers' machines.

ClickOnce
By default, when preparing a ClickOnce distribution of a Windows Forms Application, VS uses its default settings, which
assume that all project assemblies located in the GAC of the local machine are also available on the remote server. By
default, the CopyLocal property for assemblies located in the GAC is set to false, and they are marked as prerequisites in
the application manifest (meaning that ClickOnce expects these to already be present in the remote machine's GAC. As a
result, the application does not pack them). This is may cause problems if the assemblies are not registered in the remote
server's GAC.
Here are several simple steps on how to deploy a Windows Forms Application using ClickOnce:
1. Open your project in Visual Studio.
2. Go to your project's Properties.
3. Go to the Publish item.
4. Click on the Application Files... button - it will open a list of files that are required by the distribution.
5. There is a small checkbox at the bottom left corner of the opened Application Files form. If it is not checked, tick it
to see all files required by the distribution.
6. You will see all the required assemblies (that are registered in the GAC) probably with a publish status
of Prerequisite(Auto) - this means that the installation assumes the assemblies will be available in the target
machine GAC before the installation takes place.
7. Change the Publish Status field of the required assemblies from Prerequisite to Include and accept all changes.
8. Republish the project to check that all is OK.
Running an Application from a Network Drive
If your WinForms application is using Telerik controls and is located on a network drive and Telerik assemblies are also
located on the network drive you will not be able to run your application because of security attributes set to
TelerikCommon assembly. In such a case, you need to copy the whole program locally and run it. Please note that this
does not apply to publishing your application with ClickOnce on a network drive - there should be no problem publishing
your application on a network drive.
Assemblies that you should redistribute in all scenarios
 TelerikCommon.dll
 Telerik.WinControls.dll
Assemblies that you should redistribute if using Telerik Analytics
If you are using the Telerik Analytics functionality you will also need to reference
the EQATEC.Analytics.Monitor.dllassembly. For more information please check out the topic on Getting Started with
Telerik Analytics
Assemblies that you need to redistribute depending on which controls you use in your
application
Control Name Assembly
CustomShape Telerik.WinControls.dll
RadApplicationMenu Telerik.WinControls.UI.dll
RadBreadCrumb Telerik.WinControls.UI.dll
RadBulletGraph Telerik.WinControls.UI.dll
RadButton Telerik.WinControls.UI.dll
RadCalendar Telerik.WinControls.UI.dll
RadCarousel Telerik.WinControls.UI.dll
RadCheckBox Telerik.WinControls.UI.dll
RadCheckedListBox Telerik.WinControls.UI.dll
RadColorDialog Telerik.WinControls.dll
RadContextMenu Telerik.WinControls.UI.dll
RadContextMenuManager Telerik.WinControls.UI.dll
RadChart Telerik.WinControls.RadChart.dll
RadDateTimePicker Telerik.WinControls.UI.dll
RadDiagram Telerik.WinControls.RadDiagram.dll
RadDock Telerik.WinControls.RadDock.dll
RadDropDownButton Telerik.WinControls.UI.dll
RadForm Telerik.WinControls.UI.dll
RadGridView Telerik.WinControls.GridView.dll
RadHScrollBar Telerik.WinControls.UI.dll
RadLabel Telerik.WinControls.UI.dll
RadLinearGauge Telerik.WinControls.UI.dll
RadMaskedEditBox Telerik.WinControls.UI.dll
RadMenu Telerik.WinControls.UI.dll
RadMultiColumnComboBox Telerik.WinControls.GridView.dll
RadPanel Telerik.WinControls.UI.dll
RadProgressBar Telerik.WinControls.UI.dll
RadRadioButton Telerik.WinControls.UI.dll
RadRepeatButton Telerik.WinControls.UI.dll
RadRibbonBar Telerik.WinControls.UI.dll
RadRibbonForm Telerik.WinControls.UI.dll
RadRotator Telerik.WinControls.UI.dll
RadScheduler Telerik.WinControls.Scheduler.dll
RadSpinEditor Telerik.WinControls.UI.dll
RadSplitButton Telerik.WinControls.UI.dll
RadStatusStrip Telerik.WinControls.UI.dll
RadTextBox Telerik.WinControls.UI.dll
RadThemeManager Telerik.WinControls.dll
RadTitleBar Telerik.WinControls.UI.dll
RadToggleButton Telerik.WinControls.UI.dll
RadTrackBar Telerik.WinControls.UI.dll
RadVScrollBar Telerik.WinControls.UI.dll
RadWaitingBar Telerik.WinControls.UI.dll
RadRating Telerik.WinControls.UI.dll
ShapedForm Telerik.WinControls.UI.dll
SchedulerBindingDataSource Telerik.WinControls.Scheduler.dll
RadShortcuts Telerik.WinControls.dll
AquaTheme Telerik.WinControls.Themes.Aqua.dll
DesertTheme Telerik.WinControls.Themes.Desert.dll
Office2007Black Telerik.WinControls.Themes.Office2007Black.dll
Office2007Silver Telerik.WinControls.Themes.Office2007Silver.dll
TelerikMetroTheme Telerik.WinControls.Themes.TelerikMetro.dll
BreezeTheme Telerik.WinControls.Themes.Breeze.dll
HighContrastBlackTheme Telerik.WinControls.Themes.HighContrastBlack.dll
Office2010Black Telerik.WinControls.Themes.Office2010BlackTheme.dll
Office2010Blue Telerik.WinControls.Themes.Office2010BlueTheme.dll
Office2010Silver Telerik.WinControls.Themes.Office2010SilverTheme.dll
Office2010Black Telerik.WinControls.Themes.Office2010BlackTheme.dll
Windows7 Telerik.WinControls.Themes.Windows7.dll
RadMarkupDialog Telerik.WinControls.UI.RadMarkupDialog.dll
RadDropDownList Telerik.WinControls.UI.dll
RadListControl Telerik.WinControls.UI.dll
RadListView Telerik.WinControls.UI.dll
RadTreeView Telerik.WinControls.UI.dll
RadDesktopAlert Telerik.WinControls.UI.dll
RadSeparator Telerik.WinControls.UI.dll
RadWizard Telerik.WinControls.UI.dll
RadProgressBar Telerik.WinControls.UI.dll
RadOageView Telerik.WinControls.UI.dll
RadSplitContainer Telerik.WinControls.UI.dll
RadGroupBox Telerik.WinControls.UI.dll
RadPanel Telerik.WinControls.UI.dll
RadScrollablePanel Telerik.WinControls.UI.dll
RadRichTextBox Telerik.WinControls.RichTextBox.dll
RadRichTextEditor Telerik.WinControls.RichTextEditor.dll
RadSpellChecker Telerik.WinControls.SpellChecker.dll
RadPropertyGrid Telerik.WinControls.UI.dll
RadRangeSelector Telerik.WinControls.UI.dll
RadReminder Telerik.WinControls.Scheduler.dll
RadSchedulerReminder Telerik.WinControls.Scheduler.dll
RadSchedulerNavigator Telerik.WinControls.Scheduler.dll
RadCommandBar Telerik.WinControls.UI.dll
RadMessageBox Telerik.WinControls.UI.dll
RadAutoCompleteBox Telerik.WinControls.UI.dll
RadTextBoxControl Telerik.WinControls.UI.dll
RadChartView Telerik.WinControls.ChartView.dll
RadPivotGrid Telerik.WinControls.RadPivotGrid.dll
RadPivotFieldList Telerik.WinControls.RadPivotGrid.dll
RadPdfViewer Telerik.WinControls.PdfViewer.dll
RadGanttView Telerik.WinControls.UI.dll
RadBindingNavigator Telerik.WinControls.UI.dll
RadCollapsiblePanel Telerik.WinControls.UI.dll
RadDataEntry Telerik.WinControls.UI.dll
RadRadialGauge Telerik.WinControls.UI.dll
RadCheckedDropDownList Telerik.WinControls.UI.dll
Office2013Dark Telerik.WinControls.Themes.Office2013Dark.dll
Office2013Light Telerik.WinControls.Themes.Office2013Light.dll
TelerikMetroBlue Telerik.WinControls.Themes.TelerikMetroBlue.dll
TelerikMetroTouch Telerik.WinControls.Themes.TelerikMetroTouch.dll
VisualStudio2012Dark Telerik.WinControls.Themes.VisualStudio2012Dark.dll
VisualStudio2012Light Telerik.WinControls.Themes.VisualStudio2012Light.dll
 Windows8 Telerik.WinControls.Themes.Windows8.dll
RadToggleSwitch Telerik.WinControls.UI.dll
RadLayoutControl Telerik.WinControls.UI.dll
RadPopupEditor Telerik.WinControls.UI.dll
RadDataLayout Telerik.WinControls.UI.dll

Telerik UI for WinForms

Adding RadControls to Visual Studio Toolbox
Send Feedback

Telerik UI for WinForms are automatically added to Visual Studio 2005/2008/2010/2012 Toolbox during installation. If
however they do not appear in the toolbox after the installation, you can do this manually. There are two ways to manually
add Telerik UI for WinForms to the Toolbox in your Visual Studio.
Using the Visual Studio menus
1. Run Visual Studio 2005/2008/2010/2012/2013.
2. Open any windows forms project/solution.
3. Expand the Toolbox.
4. Right-click the Toolbox in the empty area underneath and choose Add Tab to create a new tab. Name the tab
"Telerik UI for WinForms ".
5. Right-click in the empty space of the newly created tab and select Choose Items. A dialog will open, which lists all
available controls from the assemblies in the GAC.
Note

If you do not see Telerik WinForms controls, please see the Troubleshooting section below.
6. Sort the assemblies by name and navigate to Telerik assemblies. Select all corresponding Telerik Controls (except
for FilteredPropertyGrid) and click OK to finish the operation.
7. All Telerik UI for WinForms should appear in the toolbox and you can start using them right away.
Using the the drag-drop approach
1. Run Visual Studio 2005/2008/2010/2012/2013.
2. Open any windows forms project/solution.
3. Expand the Toolbox.
4. Right-click the Toolbox in the empty area underneath and choose Add Tab to create a new tab. Name the tab
"Telerik UI for WinForms ".
5. Open a Windows Explorer and locate the Telerik assemblies folder.
Note

If you have installed the controls with the default settings then it would be this directory: "C:\Program Files\Telerik\UI for
WinForms\Version\Bin" for most the .NET2.0 version of our assemblies and "C:\Program Files\Telerik\UI for
WinForms\Version\Bin40" for the .NET4.0 version of the assemblies (note that currently RadRichTextBox and
RadSpellChecker are only available in the .NET4.0 version).
6. Select the following assemblies and drag-drop them to the empty space in the newly created tab in Visual Studio:
o Telerik.WinControls.RichTextBox.dll
o Telerik.WinControls.SpellChecker.dll
o Telerik.WinControls.dll
 o Telerik.WinControls.GridView.dll
o Telerik.WinControls.RadChart.dll
o Telerik.WinControls.RadDiagram.dll
o Telerik.WinControls.RadDock.dll
o Telerik.WinControls.RadMarkupEditor.dll
o Telerik.WinControls.Scheduler.dll
o Telerik.WinControls.Themes.Aqua.dll
o Telerik.WinControls.Themes.Breeze.dll
o Telerik.WinControls.Themes.Desert.dll
o Telerik.WinControls.Themes.HighContrastBlack.dll
o Telerik.WinControls.Themes.Office2007Black.dll
o Telerik.WinControls.Themes.Office2007Silver.dll
o Telerik.WinControls.Themes.Office2010Black.dll
o Telerik.WinControls.Themes.Office2010Blue.dll
o Telerik.WinControls.Themes.Office2010Silver.dll
o Telerik.WinControls.Themes.TelerikMetro.dll
o Telerik.WinControls.Themes.Windows7.dll
o Telerik.WinControls.UI.dll
o Telerik.WinControls.ChartView.dll
o Telerik.WinControls.Themes.Office2013Dark.dll
o Telerik.WinControls.Themes.Office2013Light.dll
o Telerik.WinControls.Themes.TelerikMetroBlue.dll
o Telerik.WinControls.Themes.TelerikMetroTouch.dll
o Telerik.WinControls.Themes.VisualStudio2012Dark.dll
o Telerik.WinControls.Themes.VisualStudio2012Light.dll
o Telerik.WinControls.Themes.Windows8.dll
o Telerik.WinControls.PdfViewer.dll
o Telerik.WinControls.PivotGrid.dll
o Telerik.WinControls.RichTextEditor.dll
Caution

Resetting the toolbox through the Reset context command will remove the tools from the toolbox. If you need to reset the toolbox,
just add the controls as described above.
Troubleshooting
Telerik assemblies do not appear in Visual Studio's Add reference dialog
Make sure that the Telerik WinForms controls are added in the Global Assembly Cache (GAC) as described in
the Add/Remove RadControls to the Global Assembly Cache (GAC) topic.

Telerik assemblies do not appear in Visual Studio's Add reference dialog although they are added in the GAC
To display your assembly in the Add Reference dialog box, you can add a registry key, such as the following, which
points to the location of the assembly:

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\AssemblyFolders\Telerik UI
for WinForms Q1 2014]@="C:\Program Files\Telerik\UI for WinForms\Q1 2014\bin\"
Change this according to your installation and version specifics. Restart Visual Studio .NET after you have added the key.
 Note

You can create the this registry entry under the HKEY_LOCAL_MACHINE hive. This will change the setting for all of the users
on the system. If you create this registry entry under HKEY_CURRENT_USER, this entry will affect the setting for only the current
user.
More information about this topic you could find in Microsoft Support Center: How to display an assembly in the "Add
Reference" dialog box

Repetitive RadControls entries in the Toolbox

We have identified several occurrences of multiple/duplicated ToolBox items existing in the Visual Studio Toolbox.
Unfortunately these seem to stem from a glitch in Visual Studio, which was still not reproduced reliably so that we can fix
it, or ask Microsoft for a fix.
Below are the different kinds of occurrences and their possible fixes:
 Duplicate Toolbox items, remaining two entries per control:
o this could be a result of having parallel Telerik UI for WinForms installations, which is the correct behavior
(Visual Studio 2008 only)
o this could be the result of an improper underregistration of an older Telerik UI for WinForms distribution,
followed by the registration of the newer one. Usually either of the two approaches below helps fixing the
problem:
 Close Visual Studio instances, start Windows Explorer, navigate to
%localappdata%\Microsoft\VisualStudio\10.0 and delete the *.tbd files
 Right-click the Toolbox inside Visual Studio and click Reset
 Multiple entries per control, number increasing with each start of the IDE: this is the worst scenario we have come
across. All the registry entries and files on the customer machine seemed fine in this case. The only fix we were
able to apply was a complete uninstall of Telerik UI for WinForms and Visual Studio 2010, followed by a clean
install of the IDE and the suite.

Telerik UI for WinForms

Add/Remove RadControls to the Global Assembly Cache (GAC)
Send Feedback

Adding controls to GAC by using the gacutil tool (Windows XP, Vista, Win7)
To add Telerik controls to the Global Assembly Cache (GAC):
1. Run the .NET command prompt (Start >> Programs >> Microsoft VS.NET >> VS.NET Tools >> VS.NET prompt)
2. Start the
gacutil.exe tool

with -i parameter (install) and the full path to the control's DLL. For example:

gacutil.exe -i "C:\Program Files\Telerik\UI for WinForms\Version\bin\TelerikCommon.dll"

gacutil.exe -i "C:\Program Files\Telerik\UI for WinForms\Version\bin\Telerik.WinControls.dll"
To get information on the the assembly attributes (Version, Culture, PublicKeyToken), run the gacutil /l command which
will return a list of all the assemblies in the GAC. You can also see the information associated with a particular assembly
using the -l parameter. For example:
gacutil -l TelerikCommon
The command above will return:
TelerikCommon, Version=5.0.3.0, Culture=neutral, PublicKeyToken=5bb2a467cbec79, processorArchitecture=MSIL
Removing assemblies by using the gacutil tool (Windows XP, Vista, Win7)
To remove assemblies via the gacutil tool, please see the gacutil.exe tool's help.
Adding and removing controls to GAC manually (Vista, Win7)
Simply copy the dll files from the installation directory to C:\WINDOWS\assembly. This is equivalent to running the
gacutil.exe utility.
To remove the assemblies, open C:\WINDOWS\assembly and select the assemblies you want removed. Press DELETE
on the keyboard.
 Telerik UI for WinForms
Redistributing Telerik UI for WinForms
Send Feedback

The Telerik UI for WinForms suite includes a limited run time royalty-free license to redistribute the controls in your own
solutions subject to the License Agreement. You can use the components in the suite to build your own solutions, and
redistribute your solutions to and your end users who are not required to purchase a license from Telerik to access your
solution.
Examples of Permitted Uses
 WinForms applications for internal company use.
 Commercial WinForms applications deployed to Your end users. In this case, you may deploy the Telerik
assemblies together with your application with the sole exception of
the Telerik.WinControls.UI.Design.dllassembly. The Telerik.WinControls.UI.Design.dll assembly may not be
deployed to end-users under any circumstance.
 WinForms applications that offer a trial or free version of Your application. If offering a free or trial version of
Your Integrated Product, redistribution of the assemblies is not permitted. You are required to protect all
Telerik assemblies by using one of the methods below (ILMerge to merge the Telerik WinForms assemblies
with the executable file (this does not apply to the Document processing assemblies, see below) of your
application OR build the Telerik.WinControls.dll assembly from source code using one of the approaches
described below)
Examples of Uses that Require Telerik review
 Products that expose the design-time functionality of the Telerik RadControls or the VisualStyleBuilder.
 Products that do not add significant functionality to the Telerik RadControls.
 Open source licensed products.
For additional usage requirements, development restrictions and, defined term definitions, please refer to the
WinFormslicense agreement. For uses that require additional review, please send e-mail to sales@telerik.com to discuss
your planned use of the controls.
ILMerge Telerik WinForms assemblies
RELATED
VIDEOS
ILMerge

This video
demonstrates
how to
merge your
application
exe with the
Telerik
assemblies,
so they
cannot be
reused.
(Runtime:
1:57)
When you deploy your application, you may prefer to do it as a single executable rather than an executable referencing
many external assemblies. In this case, you need to ILMerge the assemblies with the executable. Here is a link to MSDN
from where you can download the ILMerge executable: Download ILMerge
In order to use this approach you need to set the ResolverTypesInCurrentAssembly property to true in
the staticconstructor of the first form that is created and loaded when your application starts:
Note

Please make sure that you set the ResolverTypesInCurrentAssembly property in the static constructor of the form. This approach will
not work if the property is set somewhere else.
[C#]

static RedestributingTelerikRadControls()
{
Telerik.WinControls.RadTypeResolver.Instance.ResolveTypesInCurrentAssembly =
true;
}

public RedestributingTelerikRadControls()
{
InitializeComponent();
}
[VB.NET]

Shared Sub New()

Telerik.WinControls.RadTypeResolver.Instance.ResolveTypesInCurrentAssembly =
True
End Sub

Public Sub New()

' This call is required by the designer.
InitializeComponent()
' Add any initialization after the InitializeComponent() call.
End Sub
Next, you should build your solution and then ILMerge the built application executable with the Telerik assemblies:
Note

If you try to run your solution (not just build it, but run the built executable) when the ResolveTypesInCurrentAssemblyis true, you
will get an exception since the application executable is still not merged with the Telerik assemblies. Make sure that the application
executable is ILMerged with the Telerik assemblies when theResolveTypesInCurrentAssembly is true and the executable is run.
1. Press the Start button and choose Run.
2. Type "cmd" (without the quotes).
3. In the command prompt navigate to the ILMerge tool directory. Usually, the directory is C:\Program
Files\Microsoft\ILMerge, although this directory may vary depending on the Operation System version.
4. ILMerge the assemblies using the following command in the command prompt:
Note

Note: This commands will work in case the application executable and the Telerik assemblies are contained in the ILMerge tool
folder. In any other case, you will need to include the full path to the assemblies/executables. In addition, the Telerik
assemblies that should be given as parameters, should be those referenced by your application.

ilmerge /target:winexe
/out:MergedApplicationExecutable.exe ApplicationExecutable.exe TelerikCommon.dll
Telerik.WinControls.UI.dll Telerik.WinControls.dll
 Note

If the referenced assemblies are .NET 4.0 assemblies, you need to specify the targetplatform also:

ILMerge.exe /target:winexe /targetplatform:"v4,

C:\Windows\Microsoft.NET\Framework\v4.0.30319"/out:MergedApplicationExecutable.exe
AppliocationExecutable.exe Telerik.WinControls.dll Telerik.WinControls.UI.dll
TelerikCommon.dll
The MergedApplicationExecutable.exe is now a stand-alone application executable that does not need any additional
references to the Telerik assemblies.
Building the Telerik assembles from source code - using the OemAssemblyName
RELATED
VIDEOS
Redistribute
OEM

This video
demonstrates
how to build
the Telerik
assemblies,
so they are
locked to
your
application
and cannot
be reused
outside of it.
(Runtime:
5:49)
This method requires modifications to the source files, which are distributed as part of the Subscription license. If you
have purchased a Subscription license for Telerik UI for WinForms, and would like to explore this method, the following
information will allow you to do so.
Protecting Telerik UI for WinForms requires the Telerik assemblies to be built from source code. The essential part of this
approach is that you need to introduce a small modification to the Telerik.WinControls project. For brevity this document
assumes that the source distribution ZIP file is extracted in C:\Telerik UI for WinForms Source:
1. Open the following solution file: C:\Telerik UI for WinForms Source\RadControlsVS2010.sln
2. In the properties for the Telerik.WinControls project, open the Build tab and add an OEM conditional compilation
symbol, as shown below:
Before:
 After:

Note

Note: If you are building the .NET4.0 version of the assemblies, you need to use the Release40 build configuration. In this case,
when you add the "OEM" symbol, you need to keep the existing NET4 symbol - "OEM; NET4".
3. Open C:\Telerik UI for WinForms Source\RadControl\TPF\Control\ RadControl.cs in a text editor (notepad, Visual
Studio etc).
4. Uncomment the following line and change the string to you application’s assembly name:
 Before:

After:

5. Save RadControl.cs and rebuild the solution.

6. In your application replace the existing references to Telerik UI for WinForms assemblies with the ones built from
source code and rebuild your project so it will use the newly build assemblies.
Once you finish these steps, and if you or someone else tries to use that assembly from another application the evaluation
dialog will appear (randomly).
Building the Telerik assembles from source code - using the OemPublicKeyToken
RELATED
VIDEOS
Redistribute
OEMKEY

This video
demonstrates
how to build
the Telerik
assemblies,
so they are
locked to
your
application
public token
key and
cannot be
reused
outside of it.
(Runtime:
7:19)
This section demonstrates how to deploy a project with a public token key. We will assume that you have downloaded and
extracted your source code distribution in C:\Telerik UI for WinForms Source\RadControlsVS2010.sln:
1. Open the following solution file: C:\Telerik UI for WinForms Source\RadControlsVS2010.sln
2. In the properties for the Telerik.WinControls project, open the Build tab and add an OEMKEY conditional
compilation symbol, as shown below:
Before:
After:
3. Open C:\Telerik UI for WinForms Source\RadControl\TPF\Control\ RadControl.cs in a text editor (notepad, Visual
Studio etc).
4. Delete the value of the OemPublicKeyToken:
Before:
 After:

5. Open your project and go to Properties, then select the Signing tab.
6. Mark Sign the Assembly checkbox and create a new strong name key.
7. Build your project and copy the route to your executable file.
8. Open the Developer Command Prompt for your version of Visual Studio.

9. Execute the following command with a parameter the route to your assembly.

10. Copy the generated public key token.

11. Return to the RadControlsVS2010 solution, open the RadControl.cs file and set the OemPublicKeyToken to equal
the value of the newly generated key token.
 12. Build the solution.
13. In your application replace the existing references to Telerik UI for WinForms assemblies with the ones built from
source code and rebuild your project so it will use the newly build assemblies.
Using the Telerik Document Processing libraries in Your Solutions
In order to include the Telerik Document Processing libraries in your application, you should build the source code as
described below. The source code of the Document Processing libraries is distributed together with the Telerik UI for
WinForms source code and installation and is available for downloading from the client accounts. For brevity this
document assumes that the source distribution ZIP file is extracted in C:\WinFormsDPLSource
Instructions
1. Open C:\WinFormsDPLSource\Documents\Core\Core\Licensing\AssemblyProtection.cs in a text editor (notepad,
Visual Studio, etc.)
2. Uncomment the following line:
[C#] Before

public static bool IsValid()

{
// Uncomment the following line
// return ValidatePassPhrase();
return true;
}
[VB] Before

Public Shared Function IsValid() As Boolean

' Uncomment the following line
' return ValidatePassPhrase();
Return True
End Function
[C#] After

public static bool IsValid()

{
// Uncomment the following line
 return ValidatePassPhrase();
}
[VB] After

Public Shared Function IsValid() As Boolean

' Uncomment the following line
Return ValidatePassPhrase()
End Function
6. Change the ApplicationName constant to match the name of your application:
[C#] Before

internal const string ApplicationName = "MyApp";

[VB] Before

Friend Const ApplicationName As String = "MyApp"

[C#] After

internal const string ApplicationName = "Sample Application Name v2.0 (tm)";

[VB] After

Friend Const ApplicationName As String = "Sample Application Name v2.0 (tm)"

10. Save AssemblyProtection.cs and rebuild.
11. In your application replace the existing references to the Telerik assemblies with the ones built from the source
code.
12. If you run the application now you should get an exception with message “This version of Telerik UI for WinForms
is licensed only for use by Sample Application Name v2.0 (tm)”. Note that “Sample Application Name v2.0 (tm)”
will be replaced with the value of the ApplicationName constant.
Using the images from the suite in your solutions
When you install the suite together with the installation we deploy a few different kinds of images - some come with the
controls, others with the examples, with themes, etc. Following you can find information on which images can be reused
in your applications and how this can be done.
 Images displayed in the examples may not be used/reused at all by our Licensees.
 Images and other resources provided in the core product may not be used outside of the Telerik components.
 Images from one Telerik control can be reused in another Telerik control as long as the customer has obtained
licenses for both Telerik products.
Telerik UI for WinForms Assemblies
When deploying your application on customer machines, you should make sure that the following assemblies are included
in the distribution, being merged with the application executable or being recompiled with the special symbol set:
Assemblies that you should redistribute in all scenarios:
 TelerikCommon.dll
 Telerik.WinControls.dll
If you are using the Telerik Analytics functionality you will also need to reference
the EQATEC.Analytics.Monitor.dllassembly. For more information please check out the topic on Getting Started with
Telerik Analytics
Assemblies that you need to redistribute depending on which controls you use in your application
Control Name Assembly
CustomShape Telerik.WinControls.dll
RadApplicationMenu Telerik.WinControls.UI.dll
RadBreadCrumb Telerik.WinControls.UI.dll
RadBulletGraph Telerik.WinControls.UI.dll
RadButton Telerik.WinControls.UI.dll
RadCalendar Telerik.WinControls.UI.dll
RadCarousel Telerik.WinControls.UI.dll
RadCheckBox Telerik.WinControls.UI.dll
RadCheckedListBox Telerik.WinControls.UI.dll
RadColorDialog Telerik.WinControls.dll
RadContextMenu Telerik.WinControls.UI.dll
RadContextMenuManager Telerik.WinControls.UI.dll
RadChart Telerik.WinControls.RadChart.dll
RadDateTimePicker Telerik.WinControls.UI.dll
RadDiagram Telerik.WinControls.RadDiagram.dll
RadDock Telerik.WinControls.RadDock.dll
RadDropDownButton Telerik.WinControls.UI.dll
RadForm Telerik.WinControls.UI.dll
RadGridView Telerik.WinControls.GridView.dll
RadHScrollBar Telerik.WinControls.UI.dll
RadLabel Telerik.WinControls.UI.dll
RadLinearGauge Telerik.WinControls.UI.dll
RadMaskedEditBox Telerik.WinControls.UI.dll
RadMenu Telerik.WinControls.UI.dll
RadMultiColumnComboBox Telerik.WinControls.GridView.dll
RadPanel Telerik.WinControls.UI.dll
RadProgressBar Telerik.WinControls.UI.dll
RadRadioButton Telerik.WinControls.UI.dll
RadRepeatButton Telerik.WinControls.UI.dll
RadRibbonBar Telerik.WinControls.UI.dll
RadRibbonForm Telerik.WinControls.UI.dll
RadRotator Telerik.WinControls.UI.dll
RadScheduler Telerik.WinControls.Scheduler.dll
RadSpinEditor Telerik.WinControls.UI.dll
RadSplitButton Telerik.WinControls.UI.dll
RadStatusStrip Telerik.WinControls.UI.dll
RadTextBox Telerik.WinControls.UI.dll
RadThemeManager Telerik.WinControls.dll
RadTitleBar Telerik.WinControls.UI.dll
RadToggleButton Telerik.WinControls.UI.dll
RadTrackBar Telerik.WinControls.UI.dll
RadVScrollBar Telerik.WinControls.UI.dll
RadWaitingBar Telerik.WinControls.UI.dll
RadRating Telerik.WinControls.UI.dll
ShapedForm Telerik.WinControls.UI.dll
SchedulerBindingDataSource Telerik.WinControls.Scheduler.dll
RadShortcuts Telerik.WinControls.dll
AquaTheme Telerik.WinControls.Themes.Aqua.dll
DesertTheme Telerik.WinControls.Themes.Desert.dll
Office2007Black Telerik.WinControls.Themes.Office2007Black.dll
Office2007Silver Telerik.WinControls.Themes.Office2007Silver.dll
TelerikMetroTheme Telerik.WinControls.Themes.TelerikMetro.dll
BreezeTheme Telerik.WinControls.Themes.Breeze.dll
HighContrastBlackTheme Telerik.WinControls.Themes.HighContrastBlack.dll
Office2010Black Telerik.WinControls.Themes.Office2010BlackTheme.dll
Office2010Blue Telerik.WinControls.Themes.Office2010BlueTheme.dll
Office2010Silver Telerik.WinControls.Themes.Office2010SilverTheme.dll
Office2010Black Telerik.WinControls.Themes.Office2010BlackTheme.dll
Windows7 Telerik.WinControls.Themes.Windows7.dll
RadMarkupDialog Telerik.WinControls.UI.RadMarkupDialog.dll
RadDropDownList Telerik.WinControls.UI.dll
RadListControl Telerik.WinControls.UI.dll
RadListView Telerik.WinControls.UI.dll
RadTreeView Telerik.WinControls.UI.dll
RadDesktopAlert Telerik.WinControls.UI.dll
RadSeparator Telerik.WinControls.UI.dll
RadWizard Telerik.WinControls.UI.dll
RadProgressBar Telerik.WinControls.UI.dll
RadOageView Telerik.WinControls.UI.dll
RadSplitContainer Telerik.WinControls.UI.dll
RadGroupBox Telerik.WinControls.UI.dll
RadPanel Telerik.WinControls.UI.dll
RadScrollablePanel Telerik.WinControls.UI.dll
RadRichTextBox Telerik.WinControls.RichTextBox.dll
RadRichTextEditor Telerik.WinControls.RichTextEditor.dll
RadSpellChecker Telerik.WinControls.SpellChecker.dll
RadPropertyGrid Telerik.WinControls.UI.dll
RadRangeSelector Telerik.WinControls.UI.dll
RadReminder Telerik.WinControls.Scheduler.dll
RadSchedulerReminder Telerik.WinControls.Scheduler.dll
RadSchedulerNavigator Telerik.WinControls.Scheduler.dll
RadCommandBar Telerik.WinControls.UI.dll
RadMessageBox Telerik.WinControls.UI.dll
RadAutoCompleteBox Telerik.WinControls.UI.dll
RadTextBoxControl Telerik.WinControls.UI.dll
RadChartView Telerik.WinControls.ChartView.dll
RadPivotGrid Telerik.WinControls.RadPivotGrid.dll
RadFieldList Telerik.WinControls.RadPivotGrid.dll
RadPdfViewer Telerik.WinControls.PdfViewer.dll
RadGanttView Telerik.WinControls.UI.dll
RadBindingNavigator Telerik.WinControls.UI.dll
RadCollapsiblePanel Telerik.WinControls.UI.dll
RadDataEntry Telerik.WinControls.UI.dll
RadRadialGauge Telerik.WinControls.UI.dll
RadCheckedDropDownList Telerik.WinControls.UI.dll
Office2013Dark Telerik.WinControls.Themes.Office2013Dark.dll
Office2013Light Telerik.WinControls.Themes.Office2013Light.dll
TelerikMetroBlue Telerik.WinControls.Themes.TelerikMetroBlue.dll
TelerikMetroTouch Telerik.WinControls.Themes.TelerikMetroTouch.dll
VisualStudio2012Dark Telerik.WinControls.Themes.VisualStudio2012Dark.dll
VisualStudio2012Light Telerik.WinControls.Themes.VisualStudio2012Light.dll
Windows8 Telerik.WinControls.Themes.Windows8.dll
RadToggleSwitch Telerik.WinControls.UI.dll
RadLayoutControl Telerik.WinControls.UI.dll
 RadPopupEditor Telerik.WinControls.UI.dll
RadDataLayout Telerik.WinControls.UI.dll
You can find all these assemblies in the /bin folder of your installation.

Telerik UI for WinForms

Creation and configuration wizard
Send Feedback

With the new Visual Studio Extensions for WinForms you can quickly create an application pre-configured to use Telerik
UI for WinForms. The quickest way to have such a project is using the Visual Studio New Project dialog. Under the
Telerik node there is a new node – Windows, where two project templates exist:

For convenience the same project templates could be found under the Visual C# -> Windows and Visual Basic ->
Windows nodes.
After you click the OK button, you get the Project Configuration Wizard, provided by the Telerik UI for WinForms
Visual Studio Extensions. The wizard detects all the installed distributions of Telerik UI for WinForms and lists them in a
combo box. You can select a distribution which you want to be applied to your project. You can select what type of
project to be created from the Choose project type combo box: Standard, Word-Inspired or Outlook-Inspired.
You can choose to Integrate Telerik Analytics in your project and set the Analytics product key on project creation.
Selecting Standard project type will give you the choice to select which assemblies to refer into the project. You can
access the Project Configuration Wizard through the Telerik menu when you need to configure your Telerik WinForms
application or you need to convert an existing WinForms application to a Telerik WinForms application. These depend on
the active project in the Visual Studio Solution Explorer:
Specify which assemblies your project would use (Only when Standard project type is selected). When selecting a UI for
WinForms assembly all dependent controls are selected automatically and vice-versa.
Configure Telerik WinForms Application

Convert to Telerik WinForms Application

Both the menus have their context menu counterparts accessed by right clicking on the project you want to convert or
configure.
When the Project Configuration Wizard is opened it allows you to select which Telerik UI for WinForms assemblies you
would like to use and whether you want to copy the referenced assemblies to your solution folder.
In addition to the detected versions you can:
 Navigate to a folder you’ve manually downloaded and extracted a hotfix by clicking the Browse button.
 Download the latest versions available on our website using the Download button.
Note
The Add referenced assemblies to solution option is not available when using GAC based distributions.
By using the list of the WinForms Components below you can specify which of the Telerik UI for WinForms assemblies
your project would use. When selecting an assembly all dependent controls are selected automatically and vice-versa. You
can specify the themes you would like to use in your application as well. The dependencies get handled automatically.
When you click the Finish button your project gets the respective assembly references added. Any references you have
unselected get removed. Assemblies copied to your solution folder will automatically get added to source control when
using Microsoft Team Foundation Server.

Telerik UI for WinForms

Automatic dependency resolving
Send Feedback

To improve the experience of your clients and reduce your application’s size it is crucial to use only the subset of the
Telerik UI for WinForms assemblies you really need.
Some controls require multiple assemblies and mistakes are not unlikely to happen. For example, in the urge to optimize,
you could remove an assembly the project needs, thus breaking the application compilation.
When using the new Project Templates, Project Configuration Wizard or Project Upgrade Wizard, the possibility to make
such mistakes is lowered to a minimum, thanks to the dependency analysis in the Visual Studio Extensions.

The VSExtensions assembly list control is controlled by the dependency analyzer, which won’t let you select Telerik UI
for WinForms assemblies without selecting the assemblies they depend on. Both the aspects are covered:
 Selecting a Telerik UI for WinForms assembly will automatically select the additional assemblies it depends on as
well.
 Deselecting a Telerik UI for WinForms assembly will deselect assemblies depending on it along with it.
Another handy feature available in the VSExtensions assembly list control is the design-time assembly warning.
You will be warned when using an assembly that will have limited design-time support. The cause for this is the absence
of its corresponding design-time support assembly.

Telerik UI for WinForms

Design-time assembly handling
Send Feedback

Significance of the Design Assembly

Telerik.WinControls.UI.Design is the design-time assembly responsible for the proper rendering of Telerik UI for
WinForms in the Designer.
When viewing controls from the designer, Visual Studio tries to resolve the
corresponding Telerik.WinControls.UI.Design. If the assembly is not in the GAC, controls dependent on it will not be
visible when added from the toolbox.
Designer in Visual Studio 2010 SP1 showing errors when a design assembly is missing.
Actions taken during the Telerik UI for WinForms Setup
To ensure proper design time support the design assembly is added to the Global Assembly Cache during installation
from where Visual Studio can later resolve it.
Actions taken by the Telerik Visual Studio Extensions Wizards
When the Telerik Project Wizard offers you available distributions to choose it also checks whether the design assembly is
in the GAC:
 In case it is not, the option to add the corresponding Telerik.WinControls.UI.Design from the selected distribution
to GAC will be present:

Note

Elevated privileges are required to add an assembly to the GAC. In case your machine has User Account Control enabled a
permission dialog will appear later in the wizard and must be confirmed.
 In case the corresponding Telerik.WinControls.UI.Design is missing from the distribution and is not in the GAC a
warning is shown:

This indicates that Telerik.WinControls.UI.Design.dll is missing from the distribution. To avoid the errors in the
Designer you can download the chosen distribution again (making sure no files are missing) and run the wizard
again.
Location of Telerik.WinControls.UI.Design assembly
The design assembly comes along with the distribution of control assemblies. If the distribution was downloaded through
the extensions it can be found in %APPDATA%\Telerik\Updates.
 Telerik UI for WinForms
Options dialog
Send Feedback

The Visual Studio Extensions options dialog provides settings, so you can configure the Telerik Visual Studio Extensions
to best suit your needs.
It can be accessed through the Visual Studio menu Telerik | VSExtensions Options…

The Options dialog contains two sets of options that affect the Telerik UI for WinForms Visual Studio Extensions.

The settings under the General category affect all of the installed Telerik Visual Studio Extensions.
Project setup
Add referenced assemblies to solution and source control - Sets the default value for the Add referenced assemblies
to solution option in the Project Configuration Wizard
Project Upgrade Notifications for Detected Local Distributions
Suggest project upgrades for Telerik product version available on my computer – When enabled, you will be
prompted to upgrade upon opening a project, which is not using the latest version of Telerik UI for WinForms installed on
your system
Suggest upgrades when an equal Dev release detected on projects using a Trial – When enabled, you will be
prompted to upgrade if a licensed version of Telerik UI for WinForms is available on your system, but the current project
uses a trial version
Other Notifications
Notify me when a Telerik subscription I have is about to expire – When enabled, you will receive reminders if any of
your subscriptions expire within the next month.
Note
You can benefit subscription reminders only if you have saved your credentials in the Latest Version Acquirer tool.

All settings under the WinForms category affect only the Telerik UI for WinForms Visual Studio Extensions.
Select a folder for downloads
Configures the path where the extensions look for and store distributions.
Note
You can benefit subscription reminders only if you have saved your credentials in the Latest Version Acquirer tool.
Latest version retrieval
Changing the folder path will not move existing folder contents from your previous path. Please, move your previous
folder contents manually in case you want to use them.
Notifications
Show me a message when a newer version is available on www.telerik.com When enabled, you will receive
notifications if a new version of Telerik UI for WinForms is available on the Telerik website.

Telerik UI for WinForms

Toolbox configurator
Send Feedback

Starting with Q3 2010 we introduced the Toolbox Configuration utility. Its purpose is to choose which version of Telerik
UI for WinForms to be populated in the Visual Studio’s Toolbox. The user can select among all versions of the suite that
are currently on the machine and have been either installed or downloaded using the VS Extensions.
The Toolbox Configurator can be launched from the Telerik menu:
The user can make his selection using the dropdown menu which lists all versions discovered on the machine. When the
Finish button is clicked Visual Studio will be restarted so that the changes can take effect.
The Toolbox Configurator is supported in Visual Studio 2005, 2008, 2010, 2012, 2013 and 2015.
Note
The Toolbox Configurator registers the selected version of Telerik UI for WinForms in AssemblyFoldersEx. This makes them visible
in the Add Reference dialog and Choose Toolbox Items dialog (accessible from the toolbox context menu).
 Telerik UI for WinForms
Upgrade wizard
Send Feedback

An important feature in the Visual Studio Extensions is Project Upgrade Wizard.

The Upgrade Wizard (started by using the Telerik > UI for WinForms > Upgrade Wizard menu item) is used to change
the version of Telerik UI for WinForms your projects use. On the first screen of the wizard is described what will be
upgraded:

In addition to the pure assembly reference change, the upgrade wizard provides several important features:
 Check if a new version of Telerik UI for WinForms is available on the Telerik website.
 Download of a newly discovered version.
 Visual Studio toolbox update.
 Projects backup.
On the next step the wizard lists all projects from the solution, which use Telerik UI for WinForms. You can choose
which projects will be updated (it is recommended to upgrade all projects to the chosen version), the version which they
will be upgraded to and whether or not all binaries should get copied to your solution folder (useful when utilizing a build
server or working on a project collaboratively):
 Note
The Add referenced assemblies to solution option is not available when using GAC based distributions.
The next screen allows you to update the Visual Studio Toolbox with the newly selected controls, so that you avoid
accidental reference change during a control drag and drop:
The last step suggests creating a backup of your projects:
 Note
 The Telerik UI for WinForms distribution selection screen lists all the versions that can be detected automatically. These are
versions, installed by using the Windows Installer MSI package, versions, downloaded by the Upgrade Wizard and versions,
available in the GAC. Hotfixes, downloaded manually cannot be detected.
 You can use the Browse button to navigate to the folder of a manually downloaded distribution.
 You can use the Download button to access the Latest Version Acquirer tool and download the latest available version on our
website
 The distribution, downloaded by the Upgrade Wizard contains only the "hotfix" files, e.g. the barebone files, needed for a
project to run correctly. It does not contain the documentation or the Live Examples.
 A Visual Studio restart will be required in order to update your toolbox. If the automatic restart fails, a restart should be
initiated manually in order to complete the toolbox upgrade.

Telerik UI for WinForms

Automatic latest version retrieval
Send Feedback

With the Telerik Visual Studio Extensions you keep your projects in an up-to-date state. The Latest Version Acquirer tool
automatically retrieves the freshest Telerik UI for WinForms distribution, available on the Telerik website. Running
theUpgrade Wizard as a next step makes the task of latest Telerik UI for WinForms package utilization extremely easy.
Once a day, upon Visual Studio launch, the Telerik WinForms VSExtensions queue the Telerik website for a new version
of `. A dialog gets displayed when a new version is discovered:
 Note
If you've disabled the notifications, you can use the Options Dialog to activate them again.
Clicking the Get Now button starts the Latest Version Acquirer tool, prompting for your Telerik credentials and the type
of license you own in its first page. If you do not have a www.telerik.com account, you can create one through
the Registerlink.

You can check the additional information about the release by clicking the Release Notes link. This will start a browser,
navigated to a page with the release notes related to the specific version.
You can use the Save my password checkbox to save having to enter your Telerik credentials multiple times. The
persistence is done in a secure manner and credentials are saved in a per-user context. This way other users on the
machine that do not have access to your user data from downloading through your account.
If your subscription has expired, you could either proceed with downloading a trial distribution or you could renew it and
initiate the download again.
Once the download succeeds, the latest version of the ` will be available for use in the Upgrade Wizard and the New
Project Wizard.
Tip
The Download buttons of the Upgrade Wizard and the New Project Wizard launch the Latest Version Acquirer tool too.
Note
The Latest Version Acquirer tool actually downloads the hotfix zip files, containing the latest Telerik binaries and any resources vital
for the Telerik WinForms project creation. These get unpacked to the %appdata%\Telerik\Updates folder.
If you find the list of packages offered too long and you don't need the older versions, you can close Visual Studio and use Windows
Explorer to delete these distributions.

Telerik UI for WinForms

Major and Minor releases
Send Feedback

Telerik UI for WinForms has two types of official releases – major and minor releases. Examples of major releases are Q1
2011, Q3 2011 and examples of minor releases are Q3 2011 SP1, Q3 2011 SP2 and Q1 2012 SP1. Both major and minor
releases are distributed as msi installation package which follows certain upgrade logic explained below.
First, major releases can be installed in parallel on the same machine. This means that when you install new major release
it doesn’t uninstall your existing major releases. An example is that you can have Q2 2011, Q3 2011 and Q1 2012
installed at the same time.
Minor releases on the other hand can’t be installed in parallel when they are from the same major release. This means that
when you install a newer minor release it will automatically uninstall the previous version minor release which is from the
same major release. An example is that if there are two minor releases for the same major release e.g. Q1 2012 SP1 and
Q1 2012 SP2 for the Q1 2012 release then you can have only one of the specified versions.
Here are some sample scenarios:
1. Parallel major releases
1. Install Q2 2011
2. Install Q3 2011
3. Install Q1 2012
Result: all three versions (Q2 2011, Q3 2011 and Q1 2012) are installed in parallel on the machine
2. Minor releases from the same major release
1. Install Q1 2012
2. Install Q1 2012 SP1
3. Install Q1 2012 SP2
Result: only the latest version (Q1 2012 SP2) is installed on the machine
3. Minor releases from different major releases
1. Install Q3 2011
2. Install Q3 2011 SP1
3. Install Q1 2012 SP1
Result: Q3 2011 SP1 and Q1 2012 SP1 are installed on the machine
Note
Part of the Telerik UI for WinForms are the Visual Studio Extensions. Since the Visual Studio Extensions integrate into the Visual
Studio IDE they don’t support parallel versions. When newer version is installed regardless of its type (major/minor) the Visual
Studio Extensions get updated to the newer version.