Installing MM .NET Telerik Web Controls

The MM .NET Telerik Web Controls installation program can be downloaded from the main MM .NET download page. When you run the installer, it copies the MM .NET Telerik source code to your computer and adds the Telerik Web Controls assembly to the GAC. Note it does NOT install the actual Telerik assemblies on your machine. It assumes they are already there.

Step 1: Add Telerik Controls to the Global Assembly Cache

If you haven't already done so, add the Telerik web control assemblies to the Global Assembly Cache on your machine. See the Telerik documentation for information on doing this (you can search for the phrase "Global Assembly Cache").

Step 2: Installing MM .NET Telerik Web Controls

1. If this is the first time installing MM .NET Telerik Web Controls on your computer, skip to step 3. Otherwise, uninstall the old MM .NET Telerik Controls from the Add/Remove Programs dialog.

2. In Visual Studio, remove the old MM .NET Telerik controls from your Toolbox (you can remove the entire tab), then add the new controls to your Toolbox as described in the section below.

3. Install the new version of Telerik Controls (not the MM .NET specialized subclasses)

4. Install the new MM .NET Telerik controls

5. Follow Telerik's instructions for updating your existing web projects

6. Reboot your computer

Note: When you install the MM .NET Telerik Web Controls, the install program adds the following Windows Registry key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\AssemblyFolders\MM .NET Framework Telerik Web Controls

This key tells Visual Studio (and the .NET Framework) to look in this directory for assemblies.

Step 3: Adding MM .NET Telerik Web Controls to the VS ToolBox

1. Right-click on the Toolbox (not the title bar, but anywhere below it) and select Add Tab from the shortcut menu.

2. Enter MM .NET Telerik Web Controls (or something similar) as the tab name.

3. Right-click on the new tab and select Choose Items... from the shortcut menu.

4. In the Choose Toolbox Items dialog, select the .NET Framework Components tab.

5. Select all of the MM .NET Telerik Web controls in the Customize Toolbox dialog.

6. Select the checkbox next to one of the controls. This selects all highlighted controls.

7. Click the OK button, and the MM .NET Telerik Web controls should be added to your new tab in the Visual Studio Toolbox.

Step 4: Add a tagPrefix Reference to Your Web.Config File

Add the following tagprefix element to the <system.web>|<pages>|<controls> section of your web.config file (Note: Change the version number to match the current version of the RadGrid control):

<add tagPrefix="mm" namespace="OakLeaf.MM.Main.Web.UI.WebControls.Telerik" assembly="MM .NET Framework 2019 Telerik Web Controls, Version=3.5.0.0, Culture=neutral, PublicKeyToken=9af40e17342280bb"/>

Doing this prevents Visual Studio from adding a hard-coded reference to the MM .NET Telerik assembly into each of your web pages when you drop an MM .NET Telerik control on a form.

Recompiling the MM .NET Telerik Web Controls

The project’s references to the Telerik assemblies might be wrong if you installed them into a different directory other than the default. In that case, you’ll need to remove the assembly references from the project and point them to the correct location of your Telerik assemblies. In that case, you need to rebuild the MM .NET Telerik Web Controls project. To do this, you need to create your own keyFile.snk file. Here’s how to do that:

1. Open the Telerik Web Controls project in Visual Studio

2. In the Solution Explorer, right-click the project and select Properties from the shortcut menu

3. In the Property Pages form, select the Signing tab.

4. Mark the check box Sign the assembly

5. In the Choose a strong name key file drop down, select <New...>.

6. In the Create Strong Name Key File dialog, enter keyPair.snk (or you can choose some other name). You can uncheck the Protect my key file with a password check box (unless you want to secure the key file with a password), then click OK.

   This adds the new strong name key file to the project.

7. Recompile the project, and copy the DLL from the bin\Debug folder into the project's root Telerik Web Controls directory

After installation is complete, you can add the controls to your Visual Studio Toolbox and you should be ready to go!

You may need to recompile the MM .NET Infragistics project if you have an updated or hot-fixed version of DevExpress controls or if the project’s references to the Infragistic assemblies installed in a different directory other than the default. Here are the steps you need to follow:

1. Remove the Infragistics assembly references from the MM .NET Infragistics project and point them to the new version or correct location of your Infragistics assemblies.

2. To generate a new signed key pair for the assembly right-click the project and select Properties from the shortcut menu. using the sn.exe tool. Click on the Signing tab, then in the Choose a strong name key file combo box select <New...>.

3. In the Create Strong Name Key dialog enter keyPair.snk in the Key file name text box. You can uncheck Protect my key file with a password, then click OK.

After recompiling is complete, you can add the controls to your Visual Studio Toolbox and you should be ready to go!