Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions controls/forms-and-dialogs/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ The following article list Knowledge Base articles related to this section of co

|KB Article|
|----|
|[Aligning Text in RadTitleBar]({%slug form-titlebar-align-text-winforms%})|
|[Close Application after Closing All RadTabbedForms]({%slug close-application-after-closing-the-last-tabbedform%})|
|[Customizing RadMessageBox with custom theme]({%slug customizing-radmessagebox-with-custom-theme%})|
|[How to Hide the New Tab Button for the Popped out Forms]({%slug tabbedform-keep-show-new-tab-button%})|
Expand Down
1 change: 1 addition & 0 deletions controls/gridview/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,7 @@ The following article list Knowledge Base articles related to this section of co
|[How to Filter GridViewCommandColumn in RadGridView]({%slug filter-commandcolumn-in-gridview%})|
|[How to filter RadGridView by custom types]({%slug filter-grid-by-custom-type%})|
|[How to get all filtered rows in RadGridView with paging]({%slug get-all-filtered-rows-in-gridview-with-paging%})|
|[How to get selected rows in the Child Grid of RadGridView for WinForms]({%slug how-to-access-selected-hierarchy-row-radgridview-winforms%})|
|[How to Improve Scrolling Performance with Down Arrow Key in RadGridView]({%slug gridview-improve-down-arrow-key-performance%})|
|[How to Indent Select Column Checkbox for Grouped Rows]({%slug gridview-indent-selectcolumn-group-winforms%})|
|[How to Indicate Errors in RadGridView]({%slug indicate-errors-in-gridview%})|
Expand Down
1 change: 1 addition & 0 deletions controls/map/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ The following article list Knowledge Base articles related to this section of co
|[How to Create Rectangle and Ellipse Shapes in RadMap]({%slug create-map-rectangle-ellipse-shapes%})|
|[How to Deal with Empty RadMap using BingRestMapProvider]({%slug bing-map-not-loading%})|
|[How to Determine that a Single Pin or a Cluster Having Multiple Pins is Clicked]({%slug map-clicked-pin-vs-cluster%})|
|[How to show MapCallout when clicking a Single Pin or a Cluster Having Multiple Pins]({%slug map-callout-pin-cluster%})|
|[Lasso Selection in RadMap]({%slug map-lasso-selection%})|
|[Specifying a Radius for a MapPoint]({%slug map-point-with-radius%})|

Expand Down
1 change: 1 addition & 0 deletions controls/menus/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ The following article list Knowledge Base articles related to this section of co

|KB Article|
|----|
|[Adding a Vertical Separator to RadMenuItem in RadMenu for WinForms]({%slug add-vertical-separator-radmenu-winforms%})|
|[Distinguishing the Source Control of RadContextMenu]({%slug distinguishing-the-source-control-of-radcontextmenu%})|
|[How to migrate to new two columns menu]({%slug how-to-migrate-to-new-two-columns-menu%})|
|[Removing the Icon Column in RadContextMenu for WinForms]({%slug contextmenu-remove-icon-column%})|
Expand Down
1 change: 1 addition & 0 deletions controls/pdfviewer/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ The following article list Knowledge Base articles related to this section of co

|KB Article|
|----|
|[Adjusting Scroll Speed in RadPdfViewer for WinForms]({%slug pdfviewer-adjust-scroll-speed%})|
|[Fit to Width RadPdfViewer and Scroll to the Clicked Position]({%slug fit-to-width-pdf-and-locate-clicked-position%})|
|[Highlight Form Fields in RadPdfViewer]({%slug pdfviewer-highlight-form-fields%})|
|[How to Adjust Font Size for the Text Fields in PDF Forms]({%slug adjust-font-size-in-pdf-editor%})|
Expand Down
2 changes: 2 additions & 0 deletions controls/spreadsheet/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ The following article list Knowledge Base articles related to this section of co

|KB Article|
|----|
|[Exporting FloatingChartShape to Bitmap in RadSpreadsheet for WinForms]({%slug convert-floatingchartshape-to-bitmap-radspreadsheet-winforms%})|
|[Exporting FloatingImage from RadSpreadsheet Worksheet]({%slug radspreadsheet-export-floatingimage%})|
|[Fill RadSpreadsheet with DataTable]({%slug fill-spreadsheet-with-datatable%})|
|[How to Access RadSpreadsheet's Editor]({%slug access-editor-in-spreadsheet%})|
|[How to Show ToolTip for RadSpreadsheet Cell]({%slug spreadsheet-cell-tooltip%})|
Expand Down
2 changes: 2 additions & 0 deletions controls/virtualgrid/kb-related-articles.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,14 @@ The following article list Knowledge Base articles related to this section of co

|KB Article|
|----|
|[Change default filter operator in RadVirtualGrid for WinForms]({%slug virtualgrid-change-default-filter-operator%})|
|[Filter by using a CheckBox in RadVirtualGrid]({%slug filter-by-checkbox-in-virtualgrid%})|
|[Filter when Enter is pressed in RadVirtualGrid]({%slug filter-on-enter-virtualgrid%})|
|[How to apply paging with filter and sort functionalities in VirtualGrid]({%slug virtualgrid-page-filter-sort%})|
|[How to Create a Header CheckBox in VirtualGrid]({%slug virtualgrid-header-checkbox%})|
|[How to create column chooser in VirtualGrid]({%slug virtualgrid-column-chooser%})|
|[How to show column sort index in RadVirtualGrid]({%slug virtualgrid-column-sort-index%})|
|[Identifying Cut, Copy, or Paste Operations in RadVirtualGrid for WinForms]({%slug virtualgrid-identify-cut-copy-paste%})|
|[Live Data in RadVirtualGrid]({%slug live-data-in-virtualgrid%})|
|[Reorder Columns in RadVirtualGrid]({%slug reorder-columns-in-radvirtual-grid%})|
|[Row Numbers in RadVirtualGrid]({%slug row-numbers-in-virtualgrid%})|
Expand Down
10 changes: 5 additions & 5 deletions knowledge-base/add-license-as-snippet-ci-cd.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Adding Your License Key to CI/CD Platforms as a Code Snippet
description: Learn how to add your Telerik UI for .NET MAUI license as a code snippet in CI/CD environments.
description: Learn how to add your Telerik UI for .NET WinForms license as a code snippet in CI/CD environments.
type: how-to
page_title: Adding Your License Key to CI/CD Platforms as a Code Snippet
slug: add-license-as-snippet-ci-cd
tags: common, winforms,wf, cd, cd, code, snippet
tags: licensing , winforms,wf, cd, cd, code, snippet
res_type: kb
---

Expand All @@ -16,15 +16,15 @@ res_type: kb

## Description

I work in a CI/CD environment and need to activate my Telerik UI for .NET MAUI license key. My projects, however, do not use NuGet packages. How can I activate the Telerik UI for .NET MAUI without using the `Telerik.Licensing` package?
I work in a CI/CD environment and need to activate my Telerik UI for .NET WinForms license key. My projects, however, do not use NuGet packages. How can I activate the Telerik UI for .NET WinForms without using the `Telerik.Licensing` package?

## Solution

Telerik strongly recommends the use of NuGet packages whenever possible. If NuGet is not an option, configure your CI/CD tools to create a C# license file during build:

1. Go to the [License Keys page](https://www.telerik.com/account/your-licenses/license-keys) in your Telerik account.

1. On the Telerik UI for .NET MAUI row, click the **View key** link in the **SCRIPT KEY** column.
1. On the Telerik UI for .NET WinForms row, click the **View key** link in the **SCRIPT KEY** column.

1. Create a new environment variable or repository secret and add the script key as a value.

Expand All @@ -39,5 +39,5 @@ Telerik strongly recommends the use of NuGet packages whenever possible. If NuGe

* [Setting Up Your License Key]({%slug license-key%})
* [License Activation Errors and Warnings]({%slug license-errors-warnings%})
* [Frequently Asked Questions about Your Telerik UI for .NET MAUI License Key]({%slug licensing-faq%})
* [Frequently Asked Questions about Your Telerik UI for .NET WinForms License Key]({%slug licensing-faq%})
* [Adding the License Key to CI Services]({%slug add-license-to-ci-cd%})
39 changes: 39 additions & 0 deletions knowledge-base/kb-installation-cannot-load-licensing-assembly.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: Could not Load File Or Assembly Telerik.Licensing.Runtime, Version 1.4.6.0 Runtime Error
description: FileNotFoundException thrown at runtime when the version of the referenced Telerik.Licensing.Runtime dll is mismatched.
page_title: FileNotFoundException Exception Cannot Load Telerik.Licensing.Runtime Assembly
type: troubleshooting
slug: kb-installation-cannot-load-licensing-assembly
position: 0
tags: licensing, installation, telerik, licensing, license, key, load, exception
res_type: kb
---

## Environment

<table>
<tbody>
<tr>
<td>Product Version</td>
<td>2025.1.211</td>
</tr>
<tr>
<td>Product</td>
<td>UI for WinForms</td>
</tr>
</tbody>
</table>

## Description

`FileNotFoundException` is thrown at runtime, which states that the `Telerik.Licensing.Runtime` assembly cannot be loaded. The error message is something like this:

`FileNotFoundException: Could not load file or assembly 'Telerik.Licensing.Runtime, Version=1.4.6.0, Culture=neutral, PublicKeyToken=tokenhere'. The system cannot find the file specified.`

This may happen if you upgrade to 2025 Q1 from an older version. With 2025 Q1, a new [licensing mechanism]({%slug license-key%}) was introduced, which requires you to reference the `Telerik.Licensing.Runtime` dll.

## Solution

The exception means that the version of the `Telerik.Licensing.Runtime` dll mismatches the version of the version expected by the other Telerik UI for WinForms dlls. This may happen if the project references the Telerik dlls containing the component/controls from one version and the `Telerik.Licensing.Runtime` dll from another version of Telerik UI for WinForms.

To resolve the problem, make sure that all Telerik controls are referenced from the same installation place, thus using the same release version.
37 changes: 37 additions & 0 deletions knowledge-base/kb-installation-missing-license-vs-2019.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
title: No License Key Found Warning in Visual Studio 2019 When License Key is Present
description: No license key found error shown in Visual Studio 2019 .NET Framework project even when license key is installed.
page_title: No Product Reference Detected Licensing Error Shown in .NET Framework Project
type: troubleshooting
slug: kb-installation-missing-license-vs-2019
position: 0
tags: licensing,installation, telerik, licensing, license, key, not, found
res_type: kb
---

## Environment

<table>
<tbody>
<tr>
<td>Product Version</td>
<td>2025.1.211</td>
</tr>
<tr>
<td>Product</td>
<td>UI for WinForms</td>
</tr>
</tbody>
</table>

## Description

The following licensing warnings occur when building a .NET Framework project using Visual Studio 2019, when a license key is installed.

* `No Telerik or Kendo UI product references detected in project. Consult the product documentation or contanct support at progress.com`

* `No license key found`

## Solution

The error manifests because of a limitation in the licensing implementation when loaded in the specific setup. You can safely ignore it. Alternatively, use Visual Studio 2022.
39 changes: 39 additions & 0 deletions knowledge-base/kb-installation-missing-licensing-assembly.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: Could not Find Assembly Telerik.Licensing.Runtime Compile Error After Upgrade
description: Unknown build error 'Could not find assembly Telerik.Licensing.Runtime' exception after upgrade.
page_title: The Project Cannot Find Telerik.Licensing.Runtime Assembly After Upgrade
type: troubleshooting
slug: kb-installation-missing-licensing-assembly
position: 0
tags: licensing,installation, telerik, licensing, license, key
res_type: kb
---

## Environment

<table>
<tbody>
<tr>
<td>Product Version</td>
<td>2025.1.211</td>
</tr>
<tr>
<td>Product</td>
<td>UI for WinForms</td>
</tr>
</tbody>
</table>

## Description

An error occurs after upgrade that the `Telerik.Licensing.Runtime` assembly cannot be found. The error message is something like this:

`Unknown build error, 'Could not find assembly 'Telerik.Licensing.Runtime, Version=1.4.6.0, Culture=neutral, PublicKeyToken=tokenhere'. Either explicitly load this assembly using a method such as LoadFromAssemblyPath() or use a MetadataAssemblyResolver that returns a valid assembly.`

This may happen if you upgrade to 2025 Q1 from an older version. With 2025 Q1, a new [licensing mechanism]({%slug license-key%}) was introduced, which requires you to reference the `Telerik.Licensing.Runtime` dll.

## Solution

To resolve the error, reference the `Telerik.Licensing.Runtime.dll` file in the project or install the `Telerik.Licensing` NuGet package.

If you install the Telerik UI for WPF assemblies using NuGet packages, the `Telerik.Licensing` package is installed automatically and you should not see the beforementioned error.
8 changes: 8 additions & 0 deletions licensing/add-license-to-ci-cd.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ This article describes how to set up and activate your Telerik UI for .NET WinFo
When working with CI/CD platforms, always add the `Telerik.Licensing` NuGet package as a project dependency. This package activates the Telerik UI for .NET WinForms components at build time by using the provided license key.

> If you cannot use NuGet packages in your project, see the workaround in the [Adding Your License Key to CI Platforms as a Code Snippet]({%slug add-license-as-snippet-ci-cd%}) KB article.

The license activation process in a CI/CD environment involves the following steps:

1. [Download]({%slug license-key%}) a license key from your Telerik account.
Expand All @@ -24,15 +25,22 @@ The license activation process in a CI/CD environment involves the following ste
<PackageReference Include="Telerik.Licensing" Version="1.*" />
```
1. [Create an environment variable](#creating-an-environment-variable) named `TELERIK_LICENSE` and add your Telerik UI for .NET WinForms license key as a value.

## Creating an Environment Variable
The recommended approach for providing your license key to the `Telerik.Licensing` NuGet package is to use environment variables. Each CI/CD platform has a different process for setting environment variables and this article lists only some of the most popular examples.

### Azure Pipelines (YAML)

1. Create a new [user-defined variable](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=yaml%2Cbatch) named `TELERIK_LICENSE`.
1. Paste the contents of the license key file as a value.

### Azure Pipelines (Classic)

1. Create a new [user-defined variable](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=classic%2Cbatch) named `TELERIK_LICENSE`.
1. Paste the contents of the license key file as a value.

### GitHub Actions

1. Create a new [Repository Secret](https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository) or an [Organization Secret](https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization).
1. Set the name of the secret to `TELERIK_LICENSE` and paste the contents of the license file as a value.
1. After running npm install or yarn, add a build step to activate the license:
Expand Down
26 changes: 26 additions & 0 deletions licensing/kb-related-articles.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
title: KB Related Articles
page_title: KB Related Articles - Telerik UI for WinForms
description: Topics related to the Licensing mechanism of Telerik UI for WinForms.
slug: licensing-kb-related-articles
tags: kb, sdk, examples, licensing
position: 1000
published: true
---

# Knowledge Base Related Articles

The following article list Knowledge Base articles related to the License mechanism of Telerik UI for WinForms.
<!--KB Articles Table-->

|KB Article|
|----|
|[Adding Your License Key to CI/CD Platforms as a Code Snippet]({%slug add-license-as-snippet-ci-cd%})|
|[Could not Find Assembly Telerik.Licensing.Runtime Compile Error After Upgrade]({%slug kb-installation-missing-licensing-assembly%})|
|[Could not Load File Or Assembly Telerik.Licensing.Runtime, Version 1.4.6.0 Runtime Error]({%slug kb-installation-cannot-load-licensing-assembly%})|
|[No License Key Found Warning in Visual Studio 2019 When License Key is Present]({%slug kb-installation-missing-license-vs-2019%})|

## See Also

* [WinForms SDK](https://github.com/telerik/winforms-sdk)
* [All KB Articles](https://docs.telerik.com/devtools/winforms/knowledge-base)
6 changes: 5 additions & 1 deletion licensing/license-key.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ To download a license key for Telerik UI for .NET WinForms, you must have either

![Download a Telerik UI for .NET WinForms License Key](./images/download-license-key.png)

The [Progress Control Panel]({%slug installing-from-progress-control-panel%}), [automated installers]({%slug winforms/installation-deployment-and-distribution/installing-on-your-computer%}), and the [Visual Studio Extensions]({%slug winforms-installation-deployment-and-distribution-visual-studio-extensions%}) will automatically download and store your license key in your home directory. This makes it available for all projects that you develop on your local machine.
> The [Progress Control Panel]({%slug installing-from-progress-control-panel%}), [automated installers]({%slug winforms/installation-deployment-and-distribution/installing-on-your-computer%}), and the [Visual Studio Extensions]({%slug winforms-installation-deployment-and-distribution-visual-studio-extensions%}) will automatically download and store your license key in your home directory. This makes it available for all projects that you develop on your local machine.

## Activating the Telerik UI for .NET WinForms Components

Expand Down Expand Up @@ -59,6 +59,10 @@ If you cannot use NuGet packages in your project, add the license as a code snip
>important Do not publish the license key code snippet in publicly accessible repositories. This is your personal license key.


## Updating Your License Key

Whenever you purchase a new Telerik UI for WPF license or renew an existing one, always [download a new license key](#downloading-the-license-key). The new license key includes information about all previous license purchases. This process is referred to as a license key update. Once you have the new license key, use it to [activate the components](#activating-the-telerik-ui-for-net-winforms-components).

## See Also

* [License Activation Errors and Warnings]({%slug license-errors-warnings%})
Expand Down
Loading