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

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
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
6 changes: 1 addition & 5 deletions getting-started/client-blazor.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,10 +12,7 @@ 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:
>
> * **Blazor WebAssembly App**, which exists up to .NET 7.
> * **Blazor WebAssembly Standalone App** for .NET 8 and newer versions.
> This article applies only to the **Blazor WebAssembly Standalone App** Visual Studio project template 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).

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.

33 changes: 13 additions & 20 deletions getting-started/vs-code-integration/new-project-wizard.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,58 +27,51 @@ 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: Select Your License Type
#### Section 5: Select Your License Type

Select your license type - **Commercial** (**Paid**) or **Trial**.

#### Section 7: Choose How to Distribute the Client Assets
#### Section 6: 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 8: Enable or Disable Localization
#### Section 7: Configure Localization

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

#### Section 9: Select the Preferred Icon Type
#### Section 8: 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 10: Select Target Framework
#### Section 9: Select Target Framework

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

#### Section 11: Select Theme
#### Section 10: 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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be a good idea to add a temporary note to explain the redirect in the text. If people are trying to open the old URL, they might be confused why they're landing here.

---

# First Steps with Blazor Web App and Telerik UI
Expand Down
1 change: 0 additions & 1 deletion getting-started/what-you-need.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ This article describes the required steps to use the Telerik UI for Blazor compo
>
> * [Blazor Web App](slug:getting-started/web-app) template in .NET 8 or 9
> * [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
1 change: 0 additions & 1 deletion introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@ If you are new to Telerik UI for Blazor, visit the Getting Started tutorials tha

* [Get Started with a .NET 8 or 9 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
11 changes: 11 additions & 0 deletions upgrade/breaking-changes/9-0-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
title: 9.0.0
description: Handle the changes in the 9.0.0 release of the Telerik UI for Blazor components.
page_title: Breaking Changes in 9.0.0
slug: changes-in-9-0-0
position: 960
---

# Breaking Changes in 9.0.0

Telerik UI for Blazor 9.0.0 targets .NET 8 and no longer supports .NET 6 and .NET 7. For more information, see [System Requirements](slug:system-requirements).
Loading