Windows Presentation Foundation (WPF) Blazor alkalmazás létrehozása

Megjegyzés:

Ez nem a cikk legújabb verziója. Az aktuális kiadásról a cikk .NET 10-es verziójában olvashat.

Figyelmeztetés

A ASP.NET Core ezen verziója már nem támogatott. További információt a .NET és a .NET Core támogatási szabályzatában talál. Az aktuális kiadásról a cikk .NET 10-es verziójában olvashat.

Ez az oktatóanyag bemutatja, hogyan hozhat létre és futtathat WPF-alkalmazásokat Blazor . Megtudhatja, hogyan:

  • WPF-alkalmazásprojekt Blazor létrehozása
  • Razor Összetevő hozzáadása a projekthez
  • Az alkalmazás futtatása Windows rendszeren

Előfeltételek

Visual Studio-számítási feladat

Ha a .NET asztali fejlesztési számítási feladat nincs telepítve, a Visual Studio telepítőjével telepítse a számítási feladatot. További információ: Visual Studio-számítási feladatok, összetevők és nyelvi csomagok módosítása.

A Visual Studio telepítőjének számítási feladatainak kiválasztása.

WPF-projekt Blazor létrehozása

Indítsd el a Visual Studiót. A Start ablakban válassza az Új projekt létrehozása lehetőséget:

Hozzon létre egy új megoldást a Visual Studióban.

Az Új projekt létrehozása párbeszédpanelen szűrje a Projekttípus legördülő menüt az Asztali típusra. Válassza ki a WPF-alkalmazás C#-projektsablonját, és válassza a Tovább gombot:

Hozzon létre egy új projektet a Visual Studióban.

Az új projekt konfigurálása párbeszédpanelen:

  • Állítsa be a Projekt nevét a következőre WpfBlazor: .
  • Válasszon egy megfelelő helyet a projekthez.
  • Válassza a Tovább gombot.

Konfigurálja a projektet.

A További információk párbeszédpanelen válassza ki a keretrendszer verzióját a Keretrendszer legördülő listával. Válassza a Létrehozás gombot:

A WPF-projekt További információk párbeszédpanelje.

A NuGet-csomag telepítéséhez használja a Microsoft.AspNetCore.Components.WebView.Wpf:

A Microsoft.AspNetCore.Components.WebView.Wpf NuGet-csomag telepítéséhez használja a Nuget Package Managert a Visual Studióban.

A Megoldáskezelőben kattintson a jobb gombbal a projekt nevére, WpfBlazorés válassza a Projektfájl szerkesztése lehetőséget a projektfájl (WpfBlazor.csproj) megnyitásához.

A projektfájl tetején módosítsa az SDK-t a következőre Microsoft.NET.Sdk.Razor:

<Project Sdk="Microsoft.NET.Sdk.Razor">

A projektfájl meglévő <TargetFramework> tulajdonságában adjon hozzá egy Windows 10-es vagy újabb verziószámot:

<TargetFramework>net10.0-windows10.0.17763.0</TargetFramework>

Megjegyzés:

A projekt cél-keretrendszerének Windows 10-es vagy újabb verzióra történő beállítására vonatkozó korábbi útmutatás a .NET 10 kiadásával bekövetkező váltás eredménye.

A projektfájl meglévő <PropertyGroup> fájljában adja hozzá az alábbi jelölést az alkalmazás gyökérnévterének beállításához, amely WpfBlazor ebben az oktatóanyagban van meghatározva.

<RootNamespace>WpfBlazor</RootNamespace>

Megjegyzés:

A projekt gyökérnévterének beállítására vonatkozó előző útmutató egy ideiglenes kerülő megoldás. További információ: [Blazor][Wpf] Gyökérnévtérrel kapcsolatos probléma (dotnet/maui #5861).

Mentse a projektfájl módosításait (WpfBlazor.csproj).

Adjon hozzá egy _Imports.razor fájlt a projekt gyökeréhez egy @using irányelvvel a következőhöz Microsoft.AspNetCore.Components.Web: .

_Imports.razor:

@using Microsoft.AspNetCore.Components.Web

Mentse a _Imports.razor fájlt.

wwwroot Mappa hozzáadása a projekthez.

Adjon hozzá egy index.html fájlt a wwwroot mappához az alábbi korrektúrával.

wwwroot/index.html:

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>WpfBlazor</title>
    <base href="/" />
    <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
    <link href="css/app.css" rel="stylesheet" />
    <link href="WpfBlazor.styles.css" rel="stylesheet" />
</head>

<body>
    <div id="app">Loading...</div>

    <div id="blazor-error-ui" data-nosnippet>
        An unhandled error has occurred.
        <a href="" class="reload">Reload</a>
        <a class="dismiss">🗙</a>
    </div>
    <script src="_framework/blazor.webview.js"></script>
</body>

</html>

wwwroot A mappán belül hozzon létre egy css mappát.

Vegyen fel egy app.css stíluslapot a wwwroot/css mappába az alábbi tartalommal.

wwwroot/css/app.css:

html, body {
    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
}

h1:focus {
    outline: none;
}

a, .btn-link {
    color: #0071c1;
}

.btn-primary {
    color: #fff;
    background-color: #1b6ec2;
    border-color: #1861ac;
}

.valid.modified:not([type=checkbox]) {
    outline: 1px solid #26b050;
}

.invalid {
    outline: 1px solid red;
}

.validation-message {
    color: red;
}

#blazor-error-ui {
    background: lightyellow;
    bottom: 0;
    box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
    display: none;
    left: 0;
    padding: 0.6rem 1.25rem 0.7rem 1.25rem;
    position: fixed;
    width: 100%;
    z-index: 1000;
}

    #blazor-error-ui .dismiss {
        cursor: pointer;
        position: absolute;
        right: 0.75rem;
        top: 0.5rem;
    }

wwwroot/css A mappán belül hozzon létre egy bootstrap mappát. bootstrap mappába helyezze el bootstrap.min.css egy példányát. A bootstrap.min.css beszerezheti a legújabb verziót. Kövesse a Docs>Download navigációs sávra mutató hivatkozásait. Itt nem lehet közvetlen hivatkozást megadni, mert a webhely összes tartalma az URL-címben van verziószámmal ellátva.

Adja hozzá a következő Counter összetevőt a projekt gyökeréhez, amely az Counter alapértelmezett összetevő, amely a Blazor projektsablonokban található.

Counter.razor:

<h1>Counter</h1>

<p>Current count: @currentCount</p>

<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>

@code {
    private int currentCount = 0;

    private void IncrementCount()
    {
        currentCount++;
    }
}

Mentse az Counter összetevőt (Counter.razor).

Ha a MainWindow tervező nincs megnyitva, nyissa meg úgy, hogy duplán kattint a fájlra a MainWindow.xamlMegoldáskezelőben. A tervezőben MainWindow cserélje le az XAML-kódot a következőre:

<Window x:Class="WpfBlazor.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:blazor="clr-namespace:Microsoft.AspNetCore.Components.WebView.Wpf;assembly=Microsoft.AspNetCore.Components.WebView.Wpf"
        xmlns:local="clr-namespace:WpfBlazor"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
        <blazor:BlazorWebView HostPage="wwwroot\index.html" Services="{DynamicResource services}">
            <blazor:BlazorWebView.RootComponents>
                <blazor:RootComponent Selector="#app" ComponentType="{x:Type local:Counter}" />
            </blazor:BlazorWebView.RootComponents>
        </blazor:BlazorWebView>
    </Grid>
</Window>

A Megoldáskezelőben kattintson MainWindow.xaml a jobb gombbal, és válassza a Kód megtekintése parancsot:

A MainWindow-kód megtekintése.

Adja hozzá a névteret Microsoft.Extensions.DependencyInjection a fájl elejéhez MainWindow.xaml.cs :

using Microsoft.Extensions.DependencyInjection;

A konstruktoron MainWindow belül, a InitializeComponent metódushívás után adja hozzá a következő kódot:

var serviceCollection = new ServiceCollection();
serviceCollection.AddWpfBlazorWebView();
Resources.Add("services", serviceCollection.BuildServiceProvider());

Megjegyzés:

A InitializeComponent metódus automatikusan létrejön az alkalmazás összeállításakor, és hozzáadódik a hívóosztály fordítási objektumához.

A MainWindow.xaml.csfájlszintű névtérrel és megjegyzések nélkül a végleges, teljes C#-kód:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using Microsoft.Extensions.DependencyInjection;

namespace WpfBlazor;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        var serviceCollection = new ServiceCollection();
        serviceCollection.AddWpfBlazorWebView();
        Resources.Add("services", serviceCollection.BuildServiceProvider());
    }
}

Az alkalmazás futtatása

Válassza a Start gombot a Visual Studio eszköztárán:

A Visual Studio eszköztárÁnak Start gombja.

A Windows rendszeren futó alkalmazás:

A Windows rendszeren futó alkalmazás.

Következő lépések

Ez az oktatóanyag bemutatta, hogyan végezheti el az alábbi műveleteket:

  • WPF-alkalmazásprojekt Blazor létrehozása
  • Razor Összetevő hozzáadása a projekthez
  • Az alkalmazás futtatása Windows rendszeren

További információ az alkalmazásokról Blazor Hybrid :