Partilhar via

Criar um aplicativo do Windows Presentation Foundation (WPF) Blazor

Observação

Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 10 deste artigo.

Advertência

Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e do .NET Core. Para a versão atual, consulte a versão .NET 10 deste artigo.

Este tutorial mostra como criar e executar um aplicativo WPF Blazor . Você aprende a:

  • Criar um projeto de aplicativo WPF Blazor
  • Adicionar um Razor componente ao projeto
  • Executar a aplicação no Windows

Pré-requisitos

Carga de trabalho do Visual Studio

Se a carga de trabalho de desenvolvimento da área de trabalho .NET não estiver instalada, use o instalador do Visual Studio para instalar a carga de trabalho. Para obter mais informações, consulte Modificar cargas de trabalho, componentes e pacotes de idiomas do Visual Studio.

Seleção da carga de trabalho do instalador do Visual Studio.

Criar um projeto WPF Blazor

Inicie o Visual Studio. Na janela Iniciar, selecione Criar um novo projeto:

Crie uma nova solução no Visual Studio.

Na caixa de diálogo Criar um novo projeto, filtre a lista suspensa Tipo de projeto para Desktop. Selecione o modelo de projeto C# para WPF Application e selecione o botão Next :

Crie um novo projeto no Visual Studio.

Na caixa de diálogo Configurar seu novo projeto :

  • Defina o nome do projeto como WpfBlazor.
  • Escolha um local adequado para o projeto.
  • Selecione o botão Avançar.

Configure o projeto.

Na caixa de diálogo Informações adicionais, selecione a versão do framework com a lista suspensa Framework. Selecione o botão Criar :

A caixa de diálogo Informações adicionais para o projeto WPF.

Use o Gerenciador de Pacotes NuGet para instalar o Microsoft.AspNetCore.Components.WebView.Wpf pacote NuGet:

Use o Gerenciador de Pacotes Nuget no Visual Studio para instalar o pacote NuGet Microsoft.AspNetCore.Components.WebView.Wpf.

No Gerenciador de Soluções, WpfBlazorclique com o botão direito do mouse no nome do projeto e selecione Editar Arquivo de Projeto para abrir o arquivo de projeto (WpfBlazor.csproj).

Na parte superior do arquivo de projeto, altere o SDK para Microsoft.NET.Sdk.Razor:

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

Na propriedade existente <TargetFramework> do arquivo de projeto, adicione um número de versão do Windows 10 ou posterior:

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

Observação

A orientação anterior sobre como definir a versão da estrutura de destino do projeto para visar o Windows 10 ou posterior é resultado da mudança para o WebView2CompositionControl com o lançamento do .NET 10.

No arquivo de projeto existente <PropertyGroup> , adicione a seguinte marcação para definir o namespace raiz do aplicativo, que está WpfBlazor neste tutorial:

<RootNamespace>WpfBlazor</RootNamespace>

Observação

A orientação anterior sobre como definir o namespace raiz do projeto é uma solução temporária. Para obter mais informações, consulte [Blazor][Wpf] Problema relacionado ao namespace raiz (dotnet/maui #5861).

Salve as alterações no arquivo de projeto (WpfBlazor.csproj).

Adicione um _Imports.razor arquivo à raiz do projeto com uma @using diretiva para Microsoft.AspNetCore.Components.Web.

_Imports.razor:

@using Microsoft.AspNetCore.Components.Web

Guarde o ficheiro _Imports.razor.

Adicione uma wwwroot pasta ao projeto.

Adicione um index.html arquivo à wwwroot pasta com a seguinte marcação.

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>

Dentro da wwwroot pasta, crie uma css pasta.

Adicione uma app.css folha de estilo à wwwroot/css pasta com o seguinte conteúdo.

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;
    }

Dentro da wwwroot/css pasta, crie uma bootstrap pasta. Dentro da bootstrap pasta, coloque uma cópia do bootstrap.min.css. Você pode obter a versão mais recente do bootstrap.min.cssno site do Bootstrap. Siga os links da barra de navegação para Documentos>Download. Um link direto não pode ser fornecido aqui porque todo o conteúdo do site é versionado no URL.

Adicione o seguinte Counter componente à raiz do projeto, que é o componente padrão Counter encontrado nos Blazor modelos de projeto.

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++;
    }
}

Salve o Counter componente (Counter.razor).

Se o MainWindow designer não estiver aberto, abra-o clicando MainWindow.xaml duas vezes no arquivo no Gerenciador de Soluções. MainWindow No designer, substitua o código XAML pelo seguinte:

<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>

No Gerenciador de Soluções, clique com o MainWindow.xaml botão direito do mouse e selecione Exibir Código:

Veja o código MainWindow.

Adicione o namespace Microsoft.Extensions.DependencyInjection à parte superior do MainWindow.xaml.cs arquivo:

using Microsoft.Extensions.DependencyInjection;

Dentro do MainWindow construtor, após a chamada do InitializeComponent método, adicione o seguinte código:

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

Observação

O InitializeComponent método é gerado automaticamente no momento da compilação do aplicativo e adicionado ao objeto de compilação para a classe de chamada.

O código C# final e completo de MainWindow.xaml.cs com um namespace com escopo de arquivo e comentários removidos:

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());
    }
}

Executar o aplicativo

Selecione o botão Iniciar na barra de ferramentas do Visual Studio:

Botão Iniciar da barra de ferramentas do Visual Studio.

A aplicação em execução no Windows:

O aplicativo em execução no Windows.

Próximos passos

Neste tutorial, você aprendeu como:

  • Criar um projeto de aplicativo WPF Blazor
  • Adicionar um Razor componente ao projeto
  • Executar a aplicação no Windows

Saiba mais sobre Blazor Hybrid aplicações:

ASP.NET Núcleo Blazor Hybrid

  • Last updated on