You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: deployment/deploying-a-telerik-enabled-webapplication.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,10 +18,11 @@ Deploying an application that uses the Telerik UI for ASP.NET AJAX controls is d
18
18
19
19
To ensure a successful deployment, you need to check the following items:
20
20
21
-
* For the controls to be recognized by the server, the application must properly reference the Telerik.Web.UI.dll assembly.The [Included Assemblies]({%slug introduction/installation/included-assemblies%}) help article explains where you can find thefile(s) that you need.
21
+
* For the controls to be recognized by the server, the application must properly reference the Telerik.Web.UI.dll assembly.The [Included Assemblies]({%slug introduction/installation/included-assemblies%}) help article explains where you can find the file(s) that you need.
22
22
23
-
* Make sure that the needed assemblies are copied over to the production server. This often involves setting the *CopyLocal*property of the WebApplication reference to *true*. In case you are deploying the assemblies in the GAC, examine the[Working with Assemblies in the GAC](http://blogs.telerik.com/aspnet-ajax/posts/13-09-19/working-with-assemblies-in-the-global-assembly-cache)blog post.
23
+
* Make sure that the needed assemblies are copied over to the production server. This often involves setting the *CopyLocal*property of the WebApplication reference to *true*. In case you are deploying the assemblies in the GAC, examine the[Working with Assemblies in the GAC](http://blogs.telerik.com/aspnet-ajax/posts/13-09-19/working-with-assemblies-in-the-global-assembly-cache)blog post.
24
24
25
25
* Make sure that the needed additions are made to the web.config on the production server. The[web.config Settings Overview]({%slug general-information/web-config-settings-overview%}) article lists them.
26
26
27
-
* Make sure that the MS AJAX extensions are installed on the production server. You can find more information about them at[http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx](http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx).
27
+
* Make sure that the MS AJAX extensions are installed on the production server. You can find more information about them at [http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx](http://www.asp.net/AJAX/Documentation/Live/InstallingASPNETAJAX.aspx).
Copy file name to clipboardExpand all lines: deployment/deploying-on-shared-hosting.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -30,19 +30,19 @@ All Telerik controls are server controls and have to be installed on the web ser
30
30
31
31
1. Remember the application name and click OK.
32
32
33
-
1. Give full permissions to the __ASPNET__ user (if you are using IIS5) or to the __Network Service__ account (using IIS6 or IIS7, Windows Server 2003, Windows Vista/Longhorn) on the application folder. Again, before doing this step, consult with your hosting provider on how this is to be accomplished. If the provider offers thorough instructions, use them instead of the ones below. Otherwise, contact your provider to set the permissions for you.
33
+
1. Give full permissions to the **ASPNET** user (if you are using IIS5) or to the **Network Service** account (using IIS6 or IIS7, Windows Server 2003, Windows Vista/Longhorn) on the application folder. Again, before doing this step, consult with your hosting provider on how this is to be accomplished. If the provider offers thorough instructions, use them instead of the ones below. Otherwise, contact your provider to set the permissions for you.
34
34
35
35
1. Run the project.
36
36
37
37
## If you plan to deploy the controls directly on the shared hosting
38
38
39
-
1. Log into your [Telerik account](http://www.telerik.com/account/default.aspx) and click on __Manage products__ from the top menu.
39
+
1. Log into your [Telerik account](http://www.telerik.com/account/default.aspx) and click on **Manage products** from the top menu.
40
40
41
-
1. In the dropdown that appears choose from your purchased products or trial downloads the Telerik UI for ASP.NET AJAX, and click on it. If you have purchased a collection you would need to click on it and the trial downloads page will show all trial downlads directly.
41
+
1. In the dropdown that appears choose from your purchased products or trial downloads the Telerik UI for ASP.NET AJAX, and click on it. If you have purchased a collection you would need to click on it and the trial downloads page will show all trial downloads directly.
42
42
43
-
1. Click on __Download Installer and other resources__ (the Download link next to the suite if you are a trial user). You need to choose the Telerik UI for ASP.NET AJAX suite if you have purchased the collection and click its Browse all product files button.
43
+
1. Click on **Download Installer and other resources** (the Download link next to the suite if you are a trial user). You need to choose the Telerik UI for ASP.NET AJAX suite if you have purchased the collection and click its Browse all product files button.
44
44
45
-
1. Download the __Manual installation__ (__ZIP__) file.
45
+
1. Download the **Manual installation** (**ZIP**) file.
46
46
47
47
1. On the server, create a "Telerik" folder in your "inetpub/wwwroot" folder on the server.
Copy file name to clipboardExpand all lines: deployment/protecting-the-telerik-asp.net-ajax-assembly.md
+22-24Lines changed: 22 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,60 +14,60 @@ position: 4
14
14
15
15
##
16
16
17
-
__Technical guidelines for protecting Telerik UI for ASP.NET AJAX binaries when redistributed with other applications__
17
+
**Technical guidelines for protecting Telerik UI for ASP.NET AJAX binaries when redistributed with other applications**
18
18
19
19
20
20
21
21
22
22
23
23
We are providing the following suggestions to protect our IP (Intellectual Property) when redistribute our assemblies as a part of shrink-wrapped software (packaged products).
24
24
25
-
__Prerequisites__
25
+
**Prerequisites**
26
26
27
-
Protecting *Telerik UI for ASP.NET Ajax* requires the *Telerik.Web.UI*assembliy to be built from source code (due to modifications applied to the source files). The source code of Telerik UI for ASP.NET AJAX is distributed separately and is bundled with build instructions. Please read the source code building instructions beforehand.
27
+
Protecting *Telerik UI for ASP.NET Ajax* requires the *Telerik.Web.UI*assembly to be built from source code (due to modifications applied to the source files). The source code of Telerik UI for ASP.NET AJAX is distributed separately and is bundled with build instructions. Please read the source code building instructions beforehand.
28
28
29
29
For brevity this document assumes that the source distribution ZIP file is extracted in C:\TelerikControlsAjaxSource.
30
30
31
31
32
32
33
-
__Instructions__
33
+
**Instructions**
34
34
35
-
1. Open C:\TelerikControlsAjaxSource\Telerik.Web.UI\Common\AssemblyProtection.cs in a text editor (notepad, Visual Studio etc)
35
+
1. Open *C:\TelerikControlsAjaxSource\Telerik.Web.UI\Common\AssemblyProtection.cs* in a text editor (notepad, Visual Studio etc)
36
36
37
37
1. Uncomment the following line:
38
38
39
39
````C#
40
-
publicstaticvoidValidate()
41
-
{
42
-
//Uncomment the following line
43
-
//ValidatePassPhrase();
44
-
}
40
+
publicstaticvoidValidate()
41
+
{
42
+
//Uncomment the following line
43
+
//ValidatePassPhrase();
44
+
}
45
45
````
46
46
47
47
48
48
49
49
````C#
50
-
publicstaticvoidValidate()
51
-
{
52
-
//Uncomment the following line
53
-
ValidatePassPhrase();
54
-
}
50
+
publicstaticvoidValidate()
51
+
{
52
+
//Uncomment the following line
53
+
ValidatePassPhrase();
54
+
}
55
55
````
56
56
57
57
58
58
59
-
1. Change the value of the *__ApplicationName__* constant to match the name of your application:
59
+
1. Change the value of the ***ApplicationName*** constant to match the name of your application:
60
60
61
61
````C#
62
-
//Modify to match your application name
63
-
privateconststringApplicationName="MyApp";
62
+
//Modify to match your application name
63
+
privateconststringApplicationName="MyApp";
64
64
````
65
65
66
66
67
67
68
68
````C#
69
-
//Modify to match your application name
70
-
privateconststringApplicationName="Sample Application Name v2.0 (tm)";
69
+
//Modify to match your application name
70
+
privateconststringApplicationName="Sample Application Name v2.0 (tm)";
71
71
````
72
72
73
73
@@ -77,14 +77,12 @@ __Instructions__
77
77
1. In your application replace the existing reference to Telerik.Web.UI.dll with the one built from source code.
78
78
79
79
1. If you run your application now you should see the following error message (“Sample Application Name v2.0 (tm)” will be replaced with the name of your application set in step 3):
Copy file name to clipboardExpand all lines: deployment/using-the-global-assembly-cache.md
+21-27Lines changed: 21 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ position: 1
12
12
13
13
14
14
15
-
This article explains the basics on using the[Global Assembly Cache (GAC)](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)with the Telerik Controls.
15
+
This article explains the basics on using the[Global Assembly Cache (GAC)](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)with the Telerik Controls.
16
16
17
17
While this article can be used as a tutorial on working with the GAC and referencing assemblies in your project, the best source of information is the official MSDN site:
18
18
@@ -30,7 +30,7 @@ While this article can be used as a tutorial on working with the GAC and referen
30
30
31
31
The [Telerik UI for ASP.NET AJAX assemblies]({%slug introduction/installation/included-assemblies%}) are standard .NET assemblies, so all generic rules apply to them as well.
32
32
33
-
What we advise is that you __keep the Telerik.Web.Design.dll assembly in the GAC on your development machine (it is not needed in production)__(our installation wizard will put it there) in order to have access to the design-time mode of the controls, and __reference the other assemblies (Telerik.Web.UI.dll and Telerik.Web.UI.Skins.dll) from the BIN folder__.
33
+
What we advise is that you **keep the Telerik.Web.Design.dll assembly in the GAC on your development machine (it is not needed in production)**(our installation wizard will put it there) in order to have access to the design-time mode of the controls, and **reference the other assemblies (Telerik.Web.UI.dll and Telerik.Web.UI.Skins.dll) from the BIN folder**.
34
34
35
35
This article contains the following sections:
36
36
@@ -70,9 +70,9 @@ GAC is the short version of "Global Assembly Cache". It is a common place in the
70
70
71
71
## Where is the GAC
72
72
73
-
Up __until .NET 3.5__ the GAC is located in__C:\Windows\Assembly\__
73
+
Up **until .NET 3.5** the GAC is located in **C:\Windows\Assembly\**
74
74
75
-
__Since .NET 4.0__ it is in __C:\Windows\Microsoft.Net\Assembly\GAC_MSIL\__and also the shell integration was removed, so you can no longer drag-and-drop an assembly in the folder and have it registered.
75
+
**Since .NET 4.0** it is in **C:\Windows\Microsoft.Net\Assembly\GAC_MSIL\** and also the shell integration was removed, so you can no longer drag-and-drop an assembly in the folder and have it registered.
76
76
77
77
## Pros and Cons
78
78
@@ -100,7 +100,7 @@ And one that can go in either category:
100
100
101
101
## Add, Remove and View Assemblies in the GAC
102
102
103
-
First, you are going to need a tool from the .NET SDK that comes with Visual Studio – [gacutil.exe](http://msdn.microsoft.com/en-us/library/ex0ss12c%28v=VS.100%29.aspx). To run it go to-> All Programs -> Visual Studio <version> -> Visual Studio Tools -> run the [Visual Studio Command Prompt](http://msdn.microsoft.com/en-us/library/ms229859.aspx) (or Developer Command prompt, depending on the VS version you use.
103
+
First, you are going to need a tool from the .NET SDK that comes with Visual Studio – [gacutil.exe](http://msdn.microsoft.com/en-us/library/ex0ss12c%28v=VS.100%29.aspx). To run it go to-> All Programs -> Visual Studio <version> -> Visual Studio Tools -> run the [Visual Studio Command Prompt](http://msdn.microsoft.com/en-us/library/ms229859.aspx) (or Developer Command prompt, depending on the VS version you use.
104
104
105
105
### View the Assemblies in the GAC
106
106
@@ -138,7 +138,7 @@ Here is an example that removes the Q3 2014 Telerik.Web.UI.dll assembly to the G
You can read more on the subject in the[How to Uninstall an Assembly from the GAC](http://msdn.microsoft.com/en-us/library/aa559881.aspx) MSDN article.
141
+
You can read more on the subject in the[How to Uninstall an Assembly from the GAC](http://msdn.microsoft.com/en-us/library/aa559881.aspx) MSDN article.
142
142
143
143
>tip If an assembly has been added to the GAC by an automated installer, to remove it from the GAC, you must first uninstall the program that added it. The Telerik UI for ASP.NET AJAX installer adds the Telerik.Web.UI.Design.dll assembly to the GAC.
144
144
>
@@ -150,27 +150,27 @@ You can read more on the subject in the[How to Uninstall an Assembly from the GA
150
150
151
151
### In a WebSite Type of Project
152
152
153
-
In a __Web Site type of project__, the __Property Pages__ dialog can show you whether the references are from the GAC:
153
+
In a **Web Site type of project**, the **Property Pages** dialog can show you whether the references are from the GAC:
154
154
>caption Figure 1: GAC references to Telerik assemblies in a WebSite project
In a __WebApplication type of project__, you have to examinethe __reference Properties__under the __References__node in the __Project__ tree. You will see how it is not a local copy of the assembly and that the path points to the GAC:
173
+
In a **WebApplication type of project**, you have to examine the **reference Properties**under the **References** node in the **Project** tree. You will see how it is not a local copy of the assembly and that the path points to the GAC:
174
174
>caption Figure 2: GAC references to Telerik assemblies in a WebApplication project
@@ -181,49 +181,43 @@ In a __WebApplication type of project__, you have to examinethe __reference Prop
181
181
182
182
An alternative to the GUI approach below, you can simply add a few lines to theweb.config, as shown in the [How GAC References Look](#how-gac-references-look) section.
183
183
184
-
1. Open the __Property Pages__ dialog, go to the__References__tab and click __Add__:
184
+
1. Open the **Property Pages** dialog, go to the **References**tab and click **Add**:
185
185
>caption Figure 3: Open the Property Pages and add a reference.
186
-
187
186

188
187
189
188
1. Browse to the GAC to select assembly:
190
189
>caption Figure 4: Browse to the GAC and select an assembly to reference.
191
-
192
190

193
191
194
192
1. Confirm the reference properties when you make sure they are correct:
195
193
>caption Figure 5: Examine the references and close the Property Pages dialog.
196
-
197
194

The first problem you may encounter is that the .NET tab of the Add Reference dialog box in VS will not show custom assemblies you have added to the GAC, you either need a third party plugin for your IDE, or a registry key so that it can know about this third-party assembly. Manually browsing to the desired folder is an easy resolution.
219
213
220
-
Make sure to always __reference the same versions of all Telerik assemblies__ used in the project.
214
+
Make sure to always **reference the same versions of all Telerik assemblies** used in the project.
221
215
222
-
If you get the __"Could not load file or assembly…"__ error. It means the reference is typed in wrongly or the assembly is not actually in the GAC of the machine. This can also be caused by wrong version numbers (e.g. Register directives left over in old user controls). You can consider using a *bindingRedirect* element to redirect all old references to the current one you need. This is useful for SharePoint and Sitefinity scenarios.
216
+
If you get the **"Could not load file or assembly…"** error. It means the reference is typed in wrongly or the assembly is not actually in the GAC of the machine. This can also be caused by wrong version numbers (e.g. Register directives left over in old user controls). You can consider using a *bindingRedirect* element to redirect all old references to the current one you need. This is useful for SharePoint and Sitefinity scenarios.
223
217
224
-
__"CS0433: The type '<RadControlclass>' exists in both '<assemblyintheGAC>' and '<TemporaryASP.NETFilesforthesite>"__—this means there is a duplicate reference to our assembly – one that points to the GAC and one that points to a file somewhere else on the machine. To fix this, makes sure the project references are correct and clear the ASP cache.
218
+
**"CS0433: The type `<RadControl class>` exists in both `<assembly in the GAC>` and `<Temporary ASP.NET Files for the site>`"**—this means there is a duplicate reference to our assembly – one that points to the GAC and one that points to a file somewhere else on the machine. To fix this, makes sure the project references are correct and clear the ASP cache.
225
219
226
-
# See Also
220
+
##See Also
227
221
228
222
*[MSDN: Global Assembly Cache](http://msdn.microsoft.com/en-us/library/yf1d93sz.aspx)
0 commit comments