Skip to content

docs: deprecate dotnet 6 #1655

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
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
3 changes: 3 additions & 0 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -458,6 +458,9 @@ nodeversion: "16.0.0"
angularsubsetversion: "17.2.0"
kendosubsetversion: "2022.3.913"
blazoruiversion: "7.1.0"
mindotnetversion: "8"
mindotnetoutputdir: "\\bin\\Debug\\net8.0"
dotnetversions: ".NET 8 and .NET 9"

# Feedback Form Product code
productCode: REPORTING
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,5 +49,5 @@ Below are listed the available settings for formatting the data retrieved from t
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ It is possible to leverage the 2-step Authentication mechanism above to retrieve
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above

## See Also
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,5 +46,5 @@ __Inline Data String Configuration:__
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,11 @@ When you configure the ObjectDataSource component the settings below are obligat

1. Open __Visual Studio__ and create a new [Class Library](https://learn.microsoft.com/en-us/cpp/mfc/class-library-overview?view=msvc-170).

>The Standalone Report Designer for .NET Framework is a WPF application built against __.NET Framework 4.0__. For that reason, it cannot load and resolve classes from assemblies built against .NET Standard 2.1 or .NET 6+. You can see the [.NET Standard compatibility chart](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0) which explains how and when the assemblies can be loaded in different framework versions.
>The Standalone Report Designer for .NET Framework is a WPF application built against __.NET
Framework 4.0__. For that reason, it cannot load and resolve classes from assemblies built
against .NET Standard 2.1 or .NET {{site.mindotnetversion}}+. You can see the [.NET Standard compatibility chart](https://learn.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0) which explains how and when the assemblies can be loaded in different framework versions.

>The new .NET Standalone Report Designer is built for __.NET 8__ and can resolve assemblies built with `.NET Standard`, `.NET 6` and higher - [Starting the Standalone Report Designer for .NET]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%}#starting-the-standalone-report-designer-for-net).
>The new .NET Standalone Report Designer is built for __.NET 8__ and can resolve assemblies built with `.NET Standard`, `.NET {{site.mindotnetversion}}` and higher - [Starting the Standalone Report Designer for .NET]({%slug telerikreporting/designing-reports/report-designer-tools/desktop-designers/standalone-report-designer/overview%}#starting-the-standalone-report-designer-for-net).

1. Add the following piece of code from [Bind to a BusinessObject]({%slug telerikreporting/designing-reports/connecting-to-data/data-source-components/objectdatasource-component/how-to/how-to-bind-to-a-businessobject%}).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Any of the following data sources can be assigned to the DataSource property of
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above

## See Also
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ The following example shows how to connect to the __SQL Server AdventureWorks__
</configuration>
````

Configuration files in XML format are used in .NET Framework applications. In .NET Core and .NET 6/7 applications the configuration file usually is in JSON-format and is called `appsettings.json`. The configuration of connection strings section is explained in the following documentation article: [How to Host Reports Service in ASP.NET Core in .NET 6]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-6-with-minimal-api%}).
Configuration files in XML format are used in .NET Framework applications. In .NET Core and .NET 6+ applications, the configuration file usually is in JSON-format and is called `appsettings.json`. The configuration of connection strings section is explained in the following documentation article: [How to Host Reports Service in ASP.NET Core in .NET {{site.mindotnetversion}}]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-6-with-minimal-api%}).

When the connection string is stored in the configuration file, you need to specify the name of the configuration element as a value for the `ConnectionString` property of `SqlDataSource`. Specifying a value for the `ProviderName` property is no longer necessary, since that information is already present in the configuration element itself.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,5 +41,5 @@ The `SqlDataSource` component uses `ADO.NET` classes to interact with any databa
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ It is possible to leverage the 2-step Authentication mechanism above to retrieve
## Supported developer platforms

* .NET Framework 4.6.2 and above
* .NET 6 and above
* .NET {{site.mindotnetversion}} and above
* .NET Standard 2.0 and above

## See Also
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -161,14 +161,14 @@ The following code example shows the default `Telerik.ReportDesigner.Net.dll.con
<Telerik.ReportDesigner DefaultWorkingDir="Examples">
</Telerik.ReportDesigner>
<Telerik.Reporting>
<!-- Add assembly references (in .NET6 and later assemblies are resolved by file name) -->
<!-- Add assembly references (in .NET8 and later assemblies are resolved by file name) -->
<!--
<AssemblyReferences>
<add name="MyUserFunctions" />
<add name="MyBusinessObjects" />
</AssemblyReferences>
-->
<!-- Add trace listeners (in .NET6 and later assemblies that contain custom listeners are resolved by file name)-->
<!-- Add trace listeners (in .NET8 and later assemblies that contain custom listeners are resolved by file name)-->
<!--
<traceListeners>
<add name="myCustomListener" type="CustomListenersNamespace.CustomListener, CustomListenersAssembly" initializeData="Telerik.ReportDesigner.custom.log" />
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Behind the scenes, the Reporting engine calls the [ADO.NET GetSchema method](htt
null,Production,ProductCategory
````

> Schema restrictions are case-sensitive and empty arguments are respected. If you need to provide a null value for a specific argument, you can use the `null` keyword as demonstrated in the example above. The schema restrictions work only with .Net 6+
> Schema restrictions are case-sensitive and empty arguments are respected. If you need to provide a null value for a specific argument, you can use the `null` keyword as demonstrated in the example above. The schema restrictions work only with .NET {{site.mindotnetversion}}+.

![Image of the SQL Data Source wizard showing the schema restrictions field and the query builder dialog](images/srd-sqlds-wzrd-schema-restrictions.png)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Alternatively, instead of using the item template, the Designer REST service and
## Prerequisites

* [Visual Studio 2022](https://visualstudio.microsoft.com/)
* Existing .NET 6 or higher `Blazor Web App/Server/ WebAssembly` application
* Existing .NET {{site.mindotnetversion}} or higher `Blazor Web App/Server/ WebAssembly` application
* The designer consumes reports generated and served from a running REST Service. Such can be referenced from another application or it can be hosted locally in the Blazor application as described below.

## Adding the Report Designer REST Service and Configuration
Expand Down
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
---
title: Setting up in .NET
page_title: Embedding the Web Report Designer in .NET 6+
description: "Learn how to set up the Telerik Web Report Designer in .NET 6 and higher applications via the Visual Studio Item Templates or Manually."
page_title: Embedding the Web Report Designer in .NET {{site.mindotnetversion}}+
description: "Learn how to set up the Telerik Web Report Designer in .NET {{site.mindotnetversion}} and higher applications via the Visual Studio Item Templates or Manually."
slug: telerikreporting/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-.net-5-and-.net-core-3.1-applications
tags: how,to,set,up,in,.net,6,7,8,applications
tags: how,to,set,up,in,.net,{{site.mindotnetversion}},applications
published: True
position: 1
previous_url: /web-report-designer-setup-in-net-core3,/designing-reports/report-designer-tools/web-report-designer/how-to-set-up-in-.net-5-and-.net-core-3.1-applications
---

# Setting up the Web Report Designer in .NET applications

This article shows how to integrate our [Web Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%}) in `.NET 6+` applications.
This article shows how to integrate our [Web Report Designer]({%slug telerikreporting/designing-reports/report-designer-tools/web-report-designer/overview%}) in `.NET {{site.mindotnetversion}}+` applications.

The quickest way to add the web report designer to a web project is with the __Telerik Web Report Designer__ item template in Visual Studio. The item template is compatible with projects targetting `.NET 6+`. The item template adds a page with the Web Report Designer and, if needed, enables the Web Report Designer REST Service. To start the item template wizard, in Visual Studio `Solution Explorer`, select the target project. On the Project menu, click `Add` -> `New Item`. In the Add New Item search box enter "*Telerik Web Report Designer*" and select the item template which corresponds to your project type.
The quickest way to add the web report designer to a web project is with the __Telerik Web Report Designer__ item template in Visual Studio. The item template is compatible with projects targetting `.NET {{site.mindotnetversion}}+`. The item template adds a page with the Web Report Designer and, if needed, enables the Web Report Designer REST Service. To start the item template wizard, in Visual Studio `Solution Explorer`, select the target project. On the Project menu, click `Add` -> `New Item`. In the Add New Item search box enter "*Telerik Web Report Designer*" and select the item template which corresponds to your project type.

For full control, instead of using the item template, you can manually configure the REST service and add the web report designer as elaborated in the rest of this article.

## Prerequisites

1. Create a sample ASP.NET Core Project targeting .NET 6 or higher. It may be an empty Web project or a Web API project.
1. Create a sample ASP.NET Core Project targeting .NET 8 or higher. It may be an empty Web project or a Web API project.
1. Add the required dependencies:

* `Telerik.WebReportDesigner.Services`
Expand All @@ -35,7 +35,7 @@ If you don't use NuGet packages, along with the above assemblies, you need to ad

## Add Required Settings in the `Startup.cs` file

>note Some of the Visual Studio template projects, like the .NET 6 Web API project, have the required settings already added by default. In the empty .NET Web projects, you may need to add manually the settings.
>note Some of the Visual Studio template projects, like the .NET 8 Web API project, have the required settings already added by default. In the empty .NET Web projects, you may need to add manually the settings.

1. The `ConfigureServices` method inside the `Startup.cs` in the project should be modified in order to enable the Web Report Designer Service functionality. Make sure the application is configured for WebAPI controllers and call the [`AddNewtonsoftJson`](https://learn.microsoft.com/en-us/dotnet/api/microsoft.extensions.dependencyinjection.newtonsoftjsonmvcbuilderextensions.addnewtonsoftjson?view=aspnetcore-7.0) to place the __NewtonsoftJson__ serialization:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ The Web Report Designer uses a dedicated ASP.NET WebAPI REST service as a backen

## Requirements:

* The Web Report Designer can be integrated into any ASP.NET Web Application, both under `.NET Framework 4.5.1+` or `.NET 6+`.
* The Web Report Designer can be integrated into any ASP.NET Web Application, both under `.NET Framework 4.5.1+` or `.NET {{site.mindotnetversion}}+`.
* The following NuGet packages are required:

+ Telerik.Reporting
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ Now you have the project with data. The next step is to make the configurations

## Configuring the DataSource in the WebReportDesigner

When started, the application that hosts the Web Report Designer will try to resolve the registered assemblies in the configuration folder of the project. Resolving them means that the .NET runtime will try to load the assemblies into the application domain. For example, the `\bin\Debug\net6.0` folder.
When started, the application that hosts the Web Report Designer will try to resolve the registered assemblies in the configuration folder of the project. Resolving them means that the .NET runtime will try to load the assemblies into the application domain. For example, the `{{site.mindotnetoutputdir}}` folder.

1. You need to add the assembly as a reference to the project or copy it through a post-build action to the output directory of the application. Note that if the assembly depends on other assemblies, you will also have to add the dependent assemblies to the working folder.
1. In order to use the custom assembly for ObjectDataSource, it needs to be registered in the application's configuration file.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Behind the scenes, the Reporting engine calls the [ADO.NET GetSchema method](htt
null,Production,ProductCategory
````

> Schema restrictions are case-sensitive and empty arguments are respected. If you need to provide a null value for a specific argument, you can use the `null` keyword as demonstrated in the example above. The schema restrictions work only with .Net 6+.
> Schema restrictions are case-sensitive and empty arguments are respected. If you need to provide a null value for a specific argument, you can use the `null` keyword as demonstrated in the example above. The schema restrictions work only with .NET {{site.mindotnetversion}}+.

![Image of the SQL Data Source wizard showing the schema restrictions field and the query builder dialog](images/wrd-sqlds-wzrd-schema-restrictions.png)

Expand Down
8 changes: 4 additions & 4 deletions doc-output/configure-the-report-engine/processing-element.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ XML-based configuration file:
</resourceResolver>-->
<!-- The element below represents a custom implementation of resource resolver-->
<!-- The typeName should include first the class of the custom ResourceResolver(including the namespace) and the second part, be separated by a comma, is the name of the assembly that will contain that code(can be the same project)
e.g. "CSharp.Net6.Html5IntegrationDemo.CustomResourceResolver, CSharp.Net6.Html5IntegrationDemo"-->
e.g. "CSharp.Net8.Html5IntegrationDemo.CustomResourceResolver, CSharp.Net8.Html5IntegrationDemo"-->
<resourceResolver provider="custom">
<parameters>
<parameter name="typeName" value="Namespace.CustomResourceResolverClass, AssemblyName" />
Expand All @@ -60,7 +60,7 @@ XML-based configuration file:
</resourceResolver>
<!-- The element below represents a custom implementation of a sharedDataSourcer resolver-->
<!-- The typeName should include first the class of the custom ResourceResolver(including the namespace) and the second part, be separated by a comma, is the name of the assembly that will contain that code(can be the same project)
e.g. "CSharp.Net6.Html5IntegrationDemo.CustomSharedDataSourceResolver, CSharp.Net6.Html5IntegrationDemo"-->
e.g. "CSharp.Net8.Html5IntegrationDemo.CustomSharedDataSourceResolver, CSharp.Net8.Html5IntegrationDemo"-->
<sharedResourceResolver provider="custom">
<parameters>
<parameter name="typeName" value="Namespace.CustomSharedDataSourceResolverClass, AssemblyName" />
Expand Down Expand Up @@ -92,7 +92,7 @@ JSON-based configuration file:
//]
// The element below represents a custom implementation of a resource resolver
//The typeName should include first the class of the custom ResourceResolver(including the namespace) and the second part, be separated by a comma, is the name of the assembly that will contain that code(can be the same project)
// e.g. "CSharp.Net6.Html5IntegrationDemo.CustomResourceResolver, CSharp.Net6.Html5IntegrationDemo"
// e.g. "CSharp.Net8.Html5IntegrationDemo.CustomResourceResolver, CSharp.Net8.Html5IntegrationDemo"
"provider": "custom",
"parameters": [
{
Expand All @@ -117,7 +117,7 @@ JSON-based configuration file:

// The element below represents an implementation of a SharedDataSource resolver that uses a custom type provider
// The typeName should include first the class of the custom ResourceResolver(including the namespace) and the second part, be separated by a comma, is the name of the assembly that will contain that code(can be the same project)
// e.g. "CSharp.Net6.Html5IntegrationDemo.CustomSharedDataSourceResolver, CSharp.Net6.Html5IntegrationDemo"
// e.g. "CSharp.Net8.Html5IntegrationDemo.CustomSharedDataSourceResolver, CSharp.Net8.Html5IntegrationDemo"
"provider": "custom",
"parameters": [
{
Expand Down
6 changes: 3 additions & 3 deletions embedding-reports/asp-net-core-reporting.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,9 +37,9 @@ The [Telerik Reporting REST Services]({%slug telerikreporting/using-reports-in-a

There are different methods for configuring the Telerik Reporting REST Service in an ASP.NET Core Reporting project:

* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6+ with Minimal API]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-6-with-minimal-api%})
* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET 6 and .NET 8 with Top-Level Statements]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/host-reports-service-in-.net-with-controllers%})
* [Hosting the Telerik Reporting REST Service in an ASP.NET Core Application in .NET 6, .NET 8, and .NET 9 with Startup.cs]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-5%})
* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET {{site.mindotnetversion}}+ with Minimal API]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-6-with-minimal-api%})
* [Hosting the Telerik Reporting REST Service in ASP.NET Core in .NET {{site.mindotnetversion}} with Top-Level Statements]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/host-reports-service-in-.net-with-controllers%})
* [Hosting the Telerik Reporting REST Service in an ASP.NET Core Application in {{site.dotnetversions}} with Startup.cs]({%slug telerikreporting/using-reports-in-applications/host-the-report-engine-remotely/telerik-reporting-rest-services/asp.net-core-web-api-implementation/how-to-host-reports-service-in-asp.net-core-in-.net-5%})

## Displaying Reports in ASP.NET Core Web Reporting Applications

Expand Down
Loading