From 8f614843754d3026e0e81285ae00e145d26807f9 Mon Sep 17 00:00:00 2001 From: P1l3T0 Date: Thu, 22 May 2025 18:18:23 +0300 Subject: [PATCH 1/2] docs(licensing):: update instructions --- licensing/license-key.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/licensing/license-key.md b/licensing/license-key.md index e93104870..ec66b4e58 100644 --- a/licensing/license-key.md +++ b/licensing/license-key.md @@ -17,14 +17,11 @@ A missing or invalid license results in [errors and warnings]({%slug licensing/l ## Setup your License Key -Due to the differences between `Web Application Project` and `Web Site Project`, the steps to activate the license will differ. One of the easiest ways to distinguish them is by checking if the project has a project file (`.csproj`/`.vbproj`) or not. +Due to the differences between `Web Application Project` and `Web Site Project`, the steps to activate the license will differ. -- `Web Application Projects` > have a Project file. -- `Web Site Projects` > do not have a Project file. +One of the easiest ways to distinguish them is by the project file. `Web Application Projects` have a `.csproj`/`.vbproj` file, whereas the `Web Site Projects` do not. For more details about the differences you can check out the following Microsoft documentation article: [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)?redirectedfrom=MSDN). -For more details about the differences you can check out the following Microsoft documentation article: [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)?redirectedfrom=MSDN). - -### Web Application +### For Web Application To download and install your Telerik license key file: @@ -32,9 +29,9 @@ To download and install your Telerik license key file: 2. Click the **Download License Key** button. 3. Save the `telerik-license.txt` file to your user profile directory `%AppData%\Telerik\telerik-license.txt`, for example, `C:\Users\...\AppData\Roaming\Telerik\telerik-license.txt` -This will make the license key available to all Telerik applications that you develop on your local machine. If you need to activate Telerik UI for ASP.NET AJAX only in a specific application, save the `telerik-license.txt` to the root folder of this project or solution. +>This will make the license key available to all Telerik applications that you develop on your local machine. If you need to activate Telerik UI for ASP.NET AJAX only in a specific application, save the `telerik-license.txt` to the root folder of this project or solution. -### Web Site +### For Web Site The license for Web Sites projects can be activated by adding a license Script key: @@ -43,7 +40,7 @@ The license for Web Sites projects can be activated by adding a license Script k 1. Select the language (`C# KEY` or `VB KEY`) and click the `Copy and close` button to copy the Script Key to your clipboard. 1. Add a C#/VB Class file to the `App_Code` directory of your project, e.g. `App_Code\TelerikLicense.cs` and paste the Script Key from your clipboard. -To activate the license in other Web Site projects, repeat these steps. +>To activate the license in other Web Site projects, repeat these steps. ## See Also From 166ccf800c92683715b59720d6c7a6bdd791b2aa Mon Sep 17 00:00:00 2001 From: P1l3T0 Date: Fri, 23 May 2025 12:47:47 +0300 Subject: [PATCH 2/2] docslicensing): adjust article --- licensing/license-key.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/licensing/license-key.md b/licensing/license-key.md index ec66b4e58..cc11de906 100644 --- a/licensing/license-key.md +++ b/licensing/license-key.md @@ -9,7 +9,7 @@ position: 1 # Setting Up Your Telerik UI for ASP.NET AJAX License Key ->Starting with the **2025 Q1** release, the UI components from the Telerik UI for ASP.NET AJAX library require activation through a license key (trial or commercial). +Starting with **2025 Q1**, Telerik UI for ASP.NET AJAX requires activation through a License Key. The `Telerik.Web.UI.dll` assembly now depends on `Telerik.Licensing.Runtime.dll` which can be obtained from NuGet ([https://www.nuget.org/packages/Telerik.Licensing](https://www.nuget.org/packages/Telerik.Licensing)) or from the Telerik UI for ASP.NET AJAX installations. This article describes how to download your personal license key and use it to activate the Telerik UI for ASP.NET AJAX components. @@ -19,9 +19,11 @@ A missing or invalid license results in [errors and warnings]({%slug licensing/l Due to the differences between `Web Application Project` and `Web Site Project`, the steps to activate the license will differ. -One of the easiest ways to distinguish them is by the project file. `Web Application Projects` have a `.csproj`/`.vbproj` file, whereas the `Web Site Projects` do not. For more details about the differences you can check out the following Microsoft documentation article: [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)?redirectedfrom=MSDN). +`Web Application Projects` have a `.csproj`/`.vbproj` file, whereas the `Web Site Projects` do not. For more details about the differences you can check out the following Microsoft documentation article: [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)?redirectedfrom=MSDN). -### For Web Application +### Web Applications using NuGet + +Only for Web Application projects that have the `Telerik.UI.for.AspNet.Ajax.Net462` and `Telerik.Licensing` packages installed from NuGet, can be activated using a License File. Otherwise, an assembly attribute is required, see [Web Applications without NuGet and Web Sites](#web-applications-without-nuget-and-web-sites) section. To download and install your Telerik license key file: @@ -31,16 +33,18 @@ To download and install your Telerik license key file: >This will make the license key available to all Telerik applications that you develop on your local machine. If you need to activate Telerik UI for ASP.NET AJAX only in a specific application, save the `telerik-license.txt` to the root folder of this project or solution. -### For Web Site +### Web Applications without NuGet and Web Sites -The license for Web Sites projects can be activated by adding a license Script key: +Web Applications projects that do not use NuGet and Web Site projects require an assembly attribute, containing the License Key. Follow the steps below: 1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account. 1. On the Telerik UI for ASP.NET AJAX row, click the `View key` link. 1. Select the language (`C# KEY` or `VB KEY`) and click the `Copy and close` button to copy the Script Key to your clipboard. -1. Add a C#/VB Class file to the `App_Code` directory of your project, e.g. `App_Code\TelerikLicense.cs` and paste the Script Key from your clipboard. +1. Adding the License Key script: + - **Web Application**: Paste the copied key to the `Properties > AssemblyInfo` + - **Web Site**: Add a C#/VB Class file to the `App_Code` directory of your project, e.g. `App_Code\TelerikLicense.cs` and paste the Script Key from your clipboard. ->To activate the license in other Web Site projects, repeat these steps. +>To activate the license in other projects, repeat these steps. ## See Also