Skip to content

chore(common): Deprecation of .NET 6 docs #2928

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

Merged
merged 14 commits into from
May 15, 2025
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
12 changes: 0 additions & 12 deletions _contentTemplates/common/js-interop-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,6 @@

#end

#add-js-interop-file-to-getting-started-server
Add the `telerik-blazor.js` file to your main index file:

* `~/Pages/_Host.cshtml` for .NET 3.x and .NET 7
* `~/Pages/_Layout.cshtml` for .NET 6

**HTML**

@[template](/_contentTemplates/common/js-interop-file.md#js-interop-file-snippet)

#end

#js-interop-file-snippet
````HTML
<head>
Expand Down
2 changes: 0 additions & 2 deletions components/fileselect/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,8 +57,6 @@ This section applies only to Blazor **Server** apps. Blazor **WebAssembly** apps

In Blazor **Server** apps, the FileSelect uses the **SignalR WebSocket** to send files from the browser to the server .NET runtime. The default SignalR maximum message size is **32 KB**. To work with larger files, [increase the max WebSocket message size for the Blazor application](slug:common-kb-increase-signalr-max-message-size).

>tip The maximum file size supported by the framework up till .NET 5 was 2 GB and .NET 6 [removed this limit](https://github.com/dotnet/aspnetcore/pull/33900). While [Telerik UI for Blazor supports .NET version 3.1](slug:system-requirements), the FileSelect component will allow maximum file size of 2 GB.

## Drag-and-Drop File Support

The FileSelect provides built-in file drag-and-drop support, which allows users to drag one or multiple files and drop them anywhere in the component. The [`OnSelect` event](slug:fileselect-events#onselect) is raised upon dropping the file. You can handle this event to perform further actions with the selected file.
Expand Down
8 changes: 2 additions & 6 deletions getting-started/client-blazor.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,9 @@ position: 10

This article explains how to get the <a href = "https://www.telerik.com/blazor-ui" target="_blank">Telerik UI for Blazor components</a> in your Blazor WebAssembly app and start using them quickly. You will create a new application from scratch, learn how to add the UI for Blazor components to a project, and finally, add a UI component to a view.

> This article applies only to the following Visual Studio project templates:
> This article applies only to the **Blazor WebAssembly Standalone App** Visual Studio project template.
>
> * **Blazor WebAssembly App**, which exists up to .NET 7.
> * **Blazor WebAssembly Standalone App** for .NET 8 and newer versions.
>
> If you prefer the **Blazor Web App** template for .NET 8 and newer versions, then follow the [tutorial about Blazor Web Apps](slug:getting-started/web-app).
> If you prefer the **Blazor Web App** template with WebAssembly render mode, then follow the [tutorial about Blazor Web Apps](slug:getting-started/web-app).

@[template](/_contentTemplates/common/get-started.md#prerequisites-tip)

Expand Down Expand Up @@ -92,7 +89,6 @@ Use a single `TelerikRootComponent` component as a top-level component in the Bl

In the `~/Program.cs` file of the client web application, register the Telerik Blazor service.

**.NET 6 and .NET 7**
@[template](/_contentTemplates/common/js-interop-file.md#register-telerik-service-client)

Now your project can use the Telerik UI for Blazor components.
Expand Down
136 changes: 0 additions & 136 deletions getting-started/server-blazor.md

This file was deleted.

31 changes: 12 additions & 19 deletions getting-started/vs-code-integration/new-project-wizard.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,54 +27,47 @@ To create a Telerik-enabled Blazor project:

## Using the Wizard

#### Section 1: Choose How to Start the Project
The **Create New Project** wizard generates a project that is based on the Microsoft template. The app includes some Telerik UI components and the [required NuGet package reference, static assets, localization service, and the `TelerikRootComponent`](slug:getting-started/what-you-need).

The **Telerik UI for Blazor Template Wizard** provides two options to start you project:
> Earlier versions of the wizard provided the **Admin**, **Dashboard**, **CRUD**, **Form**, and **Chart** templates which are now deprecated. You can find their source code in the [`blazor-ui` repo](https://github.com/telerik/blazor-ui/tree/master/common/legacy-project-templates).

* **Start from Blank App**&mdash;allows you to create a blank project that is pre-configured for the Progress® Telerik® UI for Blazor components. You can select and add sample pages to get started (a Grid with CRUD operations form a service, a Form, Charts).
The wizard contains the following sections:

* **Start from Template** - the wizard provides a set of predefined project templates:
* **CRUD, Form, Chart**&mdash;A small app that showcases the Telerik UI Data Grid, Chart, and Form validation. The Data Grid also uses a basic CRUD service (a common pattern for data updates in production-ready applications).
* **Dashboard**&mdash;A basic dashboard that showcases the Telerik UI TileLayout component and how individual blocks (tiles) can fetch data.
* **Admin**&mdash;A small app that showcases a dashboard for administrators. The app uses some of the main Telerik UI components like the [Data Grid](slug:grid-overview), [Chart](slug:components/chart/overview), [TileLayout](slug:tilelayout-overview), [Form](slug:form-overview), and more.

The available templates vary depending on the target framework and hosting model. All of the above templates are available for the Client and Server projects for .NET 6 and .NET 7. The Hybrid projects and the .NET 8 Web App support only the **Start from Blank App** option.

#### Section 2: Select Project Name and Path
#### Section 1: Select Project Name and Path

Type your project name and select the output folder for it.

#### Section 3: Install or Update License Key
#### Section 2: Install or Update License Key

If necessary, the Telerik Visual Studio Code extension will notify you about a missing or outdated [license key](slug:installation-license-key), and will install or update it.

#### Section 4: Select UI for Blazor Version
#### Section 3: Select UI for Blazor Version

Select the preferred UI for Blazor version. Make sure that your system has access to the specified version of the UI components. You can achieve this with the [Telerik NuGet feed](slug:installation/nuget).

#### Section 5: Select Hosting Model
#### Section 4: Select Hosting Model

Here you can select the desired hosting model&mdash;[**WebApp**](slug:getting-started/web-app), [**Client** (also: WebAssembly)](slug:getting-started/client-side), [**Server**](slug:getting-started/server-side), or [**Hybrid** (a hybrid Blazor MAUI)](slug:getting-started/hybrid-blazor).

The available target framework options are updated upon selecting the hosting model.

#### Section 6: Choose How to Distribute the Client Assets
#### Section 5: Choose How to Distribute the Client Assets

Choose whether to load the required Telerik UI stylesheet and JS Interop file as [static NuGet assets](slug:getting-started/what-you-need#css-theme-and-javascript-files) or load them from the [Telerik CDN](slug:common-features-cdn).

#### Section 7: Enable or Disable Localization
#### Section 6: Configure Localization

Choose whether to use [localization](slug:globalization-localization) in the project or not.

#### Section 8: Select the Preferred Icon Type
#### Section 7: Select the Preferred Icon Type

Decide if you want to switch to using [Font Icons](slug:common-features-icons) instead of the default SVG icons.

#### Section 9: Select Target Framework
#### Section 8: Select Target Framework

The available .NET framework versions vary depending on the selected hosting model.

#### Section 10: Select Theme
#### Section 9: Select Theme

Select your desired [theme](slug:themes-overview) for your project. Click **See All Swatches** to explore the available [theme color variations](slug:themes-overview#basics).

Expand Down
1 change: 1 addition & 0 deletions getting-started/web-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ slug: getting-started/web-app
tags: get,started,first,steps,web,app,template
published: true
position: 5
previous_url: /getting-started/server-blazor
---

# First Steps with Blazor Web App and Telerik UI
Expand Down
3 changes: 1 addition & 2 deletions getting-started/what-you-need.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,8 @@ This article describes the required steps to use the Telerik UI for Blazor compo

>tip The information in this article builds on top of the step-by-step tutorials for specific Blazor application types or render modes:
>
> * [Blazor Web App](slug:getting-started/web-app) template in .NET 8 or 9
> * [Blazor Web App](slug:getting-started/web-app) template
> * [Blazor WebAssembly Standalone apps](slug:getting-started/client-side)
> * [Blazor Server apps](slug:getting-started/server-side) in .NET 6 or 7
> * [Blazor Hybrid (MAUI) apps](slug:getting-started/hybrid-blazor)
>
> The differences between the above tutorials and this page are:
Expand Down
3 changes: 1 addition & 2 deletions introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,8 @@ Visit the <a href="https://www.telerik.com/blazor-ui" target="_blank">Telerik UI

If you are new to Telerik UI for Blazor, visit the Getting Started tutorials that demonstrate how to add the Telerik components to your application:

* [Get Started with a .NET 8 or 9 Blazor Web App](slug:getting-started/web-app)
* [Get Started with a Blazor Web App](slug:getting-started/web-app)
* [Get Started with a Blazor WebAssembly Standalone App](slug:getting-started/client-side)
* [Get Started with a .NET 6 or 7 Blazor Server app](slug:getting-started/server-side)
* [Get Started with Blazor Hybrid](slug:getting-started/hybrid-blazor)

>tip This online Blazor documentation covers the latest version of Telerik UI for Blazor, which is `{{site.uiForBlazorLatestVersion}}`. If needed, [download the offline PDF Blazor documentation](#learning-resources) for the required older product version.
Expand Down
32 changes: 2 additions & 30 deletions knowledge-base/common-increase-signalr-max-message-size.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Blazor Server apps use a **SignalR WebSocket** to communicate between the client

Increase the `MaximumReceiveMessageSize` via `HubOptions`. The syntax and code placement can vary, depending on the .NET version or when the application was created. Here are a few possible alternatives.

>caption Program.cs (.NET 6+)
>caption Use `Configure<HubOptions>` in Program.cs

<div class="skip-repl"></div>

Expand All @@ -64,7 +64,7 @@ builder.Services.Configure<HubOptions>(options =>
});
````

>caption Use AddHubOptions in .NET 6+
>caption Use `AddHubOptions` in Program.cs

<div class="skip-repl"></div>

Expand All @@ -74,34 +74,6 @@ builder.Services.AddServerSideBlazor().AddHubOptions(options => {
});
````

>caption Startup.cs (.NET 3.1)

<div class="skip-repl"></div>

````CS
using Microsoft.AspNetCore.SignalR;

public void ConfigureServices(IServiceCollection services)
{
services.AddServerSideBlazor();

services.Configure<HubOptions>(options =>
{
options.MaximumReceiveMessageSize = 1024 * 1024; // 1MB or use null
});
}
````

>caption Use AddHubOptions in .NET 3.1

<div class="skip-repl"></div>

````CS
services.AddServerSideBlazor().AddHubOptions(options => {
options.MaximumReceiveMessageSize = null; // no limit or use a number
});
````

Also see these Microsoft articles:

* [ASP.NET Core SignalR configuration](https://learn.microsoft.com/en-us/aspnet/core/signalr/configuration)
Expand Down
10 changes: 4 additions & 6 deletions system-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,16 +16,14 @@ Telerik UI for Blazor steps on Microsoft Blazor. You can host and run Telerik Bl

## .NET Versions Support

The latest version of Telerik UI for Blazor (currently {{site.uiForBlazorLatestVersion}}) targets `net6.0`. Thus, apps and libraries that reference our package must use one of the following target frameworks:
The latest version of Telerik UI for Blazor (currently {{site.uiForBlazorLatestVersion}}) targets `net8.0`. Thus, apps and libraries that reference our package must use one of the following target frameworks:

* `net6.0`
* `net7.0`
* `net8.0`
* `net9.0`

Razor Class Libraries may target `netstandard2.0` by default, so you need to update that.

> If your application targets an [older framework version, the latest Telerik UI for Blazor you can use is `4.6.0`](#compatible-net-versions).
> If your application targets an [older framework version, you can only use older Telerik UI for Blazor versions](#compatible-net-versions).
### Supported .NET Versions

Expand All @@ -48,8 +46,8 @@ A **compatible .NET version** is one that is no longer (or not yet) officially s
| .NET version | First UI for Blazor Version | Last UI for Blazor Version |
| --- | --- | --- |
| .NET 7 | 3.7.0 | {{site.uiForBlazorLatestVersion}} (current official) |
| .NET 6 | 2.29.0 | {{site.uiForBlazorLatestVersion}} (current official) |
| .NET 7 | 3.7.0 | 8.1.1 |
| .NET 6 | 2.29.0 | 8.1.1 |
| .NET 5 | 2.19.0 | 4.6.0 |
| .NET Core 3.1 | 2.5.0 | 4.6.0 |

Expand Down
Loading
Loading