Liens

Introduction to ASP.NET Core Blazor

Description

Développement frontend avec C#
Intégration des bibliothèques .NET existantes (nuget)

WebAssembly

Permet d'exécuter du bytecode (code intermediaire) dans le navigateur grâce à la javascript runtime sandbox.
WebAssembly est nativement présent dans les navigateurs moderne.
WebAssembly possède un runtime .NET (mono.wasm), ce qui permet d'exécuter des assemblies .NET dans le navigateur.

Créer une application

# Blazor WebAssembly
dotnet new -i Microsoft.AspNetCore.Blazor.Templates::3.1.0-preview4.19579.2
dotnet new blazorwasm -o blazorwasm
cd blazorwasm
dotnet run

# Blazor server
dotnet new blazorserver -o blazorserver
cd blazorserver
dotnet run

Hosting models

Blazor WebAssembly

L'application est téléchargée et exécutée dans le navigateur.

Excellentes performances
Pas besoin d'un serveur web ASP.NET Core pour héberger l'application
Permet une utilisation offline une fois chargée
Le temps de chargement est long, il faut télécharger l'application, ses dépendances et le .NET runtime
Les identifiants pour les accès aux bdd et web API sont chargés par chaque client

Blazor Server

L'application est exécutée sur le serveur. UI updates, event handling et les appels JavaScript sont pris en charge grâce à une connexion SignalR.

Pas besoin de WebAssembly
Chaque interaction utilisateur nécessite un appel au serveur
Un serveur web ASP.NET Core est nécessaire pour héberger l'application

Blazor server application

C'est une ASP.NET Core application.

Arborescence de fichiers

Program.cs: point d'entrée, appelle Startup.cs
Startup.cs: configuration (DI)
Pages: Components
Shared: shared Components comme les layouts (main, menu)
App.razor: routing
_Imports.razor: import namespaces
wwwroot: static files (css, js)
Data: service to access data

Code in the same page vs Code-behind

Code in the same page

MyPage.razor

@page "/mypage"
<h1>Title</h1>

@code {
    // some C# code
}

Code-behind

MyPage.razor

@page "/mypage"
@inherits MyPageBase
<h1>Title</h1>

MyPageBase.cs

public class MyPageBase : ComponentBase
{
    // some C# code
}

Components

MyComponent.razor

@* si c'est une page, son url *@
@page "/employee"
@* si c'est une page, son url avec un parameter *@
@page "/employee/{EmployeeId}"

@code {
    [Parameter]
    public string EmployeeId { get; set; }
}

Layout

App.razor

<Router AppAssembly="@typeof(Program).Assembly">
    <Found Context="routeData">
        @* définit le layout par défaut *@
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
    </Found>
    <NotFound>
        <LayoutView Layout="@typeof(MainLayout)">
            <p>Sorry, there's nothing at this address.</p>
        </LayoutView>
    </NotFound>
</Router>

Shared/MainLayout.razor

@inherits LayoutComponentBase

<div class="sidebar">
    <NavMenu />
</div>

<div class="main">
    <div class="content px-4">
        @Body
    </div>
</div>

Blazor .NET Core 3.1

Sommaire