Modelos de hospedagem do ASP.NET Core Blazor

Este artigo explica Blazor modelos de hospedagem, focados principalmente em aplicativos Blazor Server e Blazor WebAssembly em versões do .NET anteriores ao .NET 8. A orientação neste artigo é relevante em todas as versões do .NET para aplicativos Blazor Hybrid executados em plataformas móveis e de desktop nativas. Blazor Web Apps no .NET 8 ou posterior são melhor compreendidos pela forma como os componentes Razor são renderizados, descrito como seu modo de renderização . Os modos de renderização são brevemente abordados no artigo de visão geral dos fundamentos e abordados em detalhes nos modos de renderização do ASP.NET Core Blazor do nó de componentes do .

Este artigo explica os modelos de hospedagem Blazor e como escolher qual usar.

Blazor é uma estrutura da Web para a criação de componentes da interface do usuário da Web (Razor componentes) que podem ser hospedados de diferentes maneiras. Razor componentes podem ser executados no lado do servidor no ASP.NET Core (Blazor Server) versus no lado do cliente no navegador num runtime .NET baseado em WebAssembly (Blazor WebAssembly, Blazor Wasm). Você também pode hospedar componentes Razor em aplicações móveis e de desktop nativas que renderizam num controlo Web View incorporado (Blazor Hybrid). Independentemente do modelo de hospedagem, a maneira como você constrói Razor componentes é a mesma. Os mesmos componentes Razor podem ser usados com qualquer um dos modelos de hospedagem inalterados.

Blazor é uma estrutura da Web para a criação de componentes da interface do usuário da Web (Razor componentes) que podem ser hospedados de diferentes maneiras. Razor componentes podem ser executados no lado do servidor no ASP.NET Core (Blazor Server) versus no lado do cliente no navegador num runtime .NET baseado em WebAssembly (Blazor WebAssembly, Blazor Wasm). Independentemente do modelo de hospedagem, a maneira como você constrói Razor componentes é a mesma. Os mesmos componentes Razor podem ser usados com qualquer um dos modelos de hospedagem inalterados.

No cliente, o script Blazor estabelece a conexão SignalR com o servidor. O script é servido como um ativo web estático com compressão automática e impressão digital .

No cliente, o script Blazor estabelece a conexão SignalR com o servidor. O script é servido a partir de um recurso incorporado na estrutura compartilhada do ASP.NET Core.

Blazor Web Apps pode usar o modelo de hospedagem para permitir a interatividade do lado do Blazor WebAssembly cliente. Quando um aplicativo é criado que é executado exclusivamente no modelo de hospedagem sem renderização e interatividade no servidor, o aplicativo é chamado de aplicativo autônomo .

Quando a aplicação Blazor WebAssembly é criada para implantação sem uma aplicação back-end ASP.NET Core para servir os seus ficheiros, a aplicação é chamada de aplicação Blazor WebAssembly autónoma.

Quando uma aplicação autónoma usa um back-end ASP.NET Core para servir os seus ficheiros, a aplicação é chamada de aplicação hospedada . Usando Blazor WebAssemblyhospedados, você obtém uma experiência de desenvolvimento web full-stack com .NET, incluindo a capacidade de compartilhar código entre os aplicativos cliente e servidor, suporte para pré-renderização e integração com MVC e Razor Pages. Um aplicativo cliente hospedado pode interagir com seu aplicativo de servidor back-end pela rede usando uma variedade de estruturas e protocolos de mensagens, como de API da Web, gRPC-web e SignalR (Use ASP.NET Core SignalR com Blazor).

Um aplicativo Blazor WebAssembly criado como um Progressive Web App (PWA) usa APIs de navegador modernas para habilitar muitos dos recursos de um aplicativo cliente nativo, como trabalhar offline, executar em sua própria janela de aplicativo, iniciar a partir do sistema operacional do host, receber notificações por push e atualizar automaticamente em segundo plano.

O interpretador de .NET Intermediate Language (IL) inclui suporte parcial just-in-time (JIT) tempo de execução para obter melhor desempenho de tempo de execução. O interpretador JIT otimiza a execução de bytecodes do interpretador substituindo-os por pequenos blobs de código WebAssembly. O interpretador JIT é ativado automaticamente para aplicativos Blazor WebAssembly, exceto durante a depuração.

Blazor suporta compilação ahead-of-time (AOT), onde você pode compilar seu código .NET diretamente no WebAssembly. A compilação AOT resulta em melhorias de desempenho em tempo de execução às custas de um tamanho de aplicativo maior. Para obter mais informações, consulte ASP.NET Core Blazor WebAssembly ferramentas de build e compilação antecipada (AOT).

O mesmo ferramentas de compilação do .NET WebAssembly usadas para compilação AOT também revincular o de tempo de execução do .NET WebAssembly para cortar o código de tempo de execução não utilizado. Blazor também corta o código não utilizado das bibliotecas do .NET framework. O compilador .NET ainda pré-compacta um aplicativo Blazor WebAssembly autônomo para uma carga útil de aplicativo menor.

Os componentes Razor renderizados pelo WebAssembly podem utilizar dependências nativas construídas para serem executadas no WebAssembly.

Blazor WebAssembly inclui suporte para cortar código não utilizado de bibliotecas .NET. Para obter mais informações, consulte ASP.NET Core Blazor globalização e localização.

Blazor Hybrid

Blazor também pode ser usado para criar aplicativos cliente nativos usando uma abordagem híbrida. Os aplicativos híbridos são aplicativos nativos que aproveitam as tecnologias da Web para sua funcionalidade. Em uma aplicação Blazor Hybrid, os componentes Razor são executados diretamente na aplicação nativa (não no WebAssembly) juntamente com qualquer outro código .NET e renderizam a interface web baseada em HTML e CSS para um controlo incorporado Web View através de um canal de interoperabilidade local.

Blazor Hybrid aplicativos podem ser criados usando diferentes estruturas de aplicativos nativos do .NET, incluindo .NET MAUI, WPF e Windows Forms. Blazor fornece controles BlazorWebView para adicionar componentes Razor a aplicativos criados com essas estruturas. Usar o Blazor com o .NET MAUI oferece uma maneira conveniente de criar aplicativos de Blazor Hybrid multiplataforma para dispositivos móveis e desktop, enquanto a integração Blazor com WPF e Windows Forms pode ser uma ótima maneira de modernizar aplicativos existentes.

Como Blazor Hybrid aplicativos são aplicativos nativos, eles podem oferecer suporte a funcionalidades que não estão disponíveis apenas com a plataforma Web. Blazor Hybrid aplicativos têm acesso total aos recursos nativos da plataforma por meio de APIs .NET normais. Blazor Hybrid aplicativos também podem compartilhar e reutilizar componentes com aplicativos Blazor Server ou Blazor WebAssembly existentes. Blazor Hybrid aplicativos combinam os benefícios da Web, aplicativos nativos e a plataforma .NET.

O modelo de hospedagem Blazor Hybrid oferece vários benefícios:

• Reutilize componentes existentes que podem ser compartilhados em dispositivos móveis, desktops e Web.
• Aproveite as habilidades, a experiência e os recursos de desenvolvimento web.
• Os aplicativos têm acesso total aos recursos nativos do dispositivo.

O modelo de hospedagem Blazor Hybrid tem as seguintes limitações:

• Aplicativos cliente nativos separados devem ser criados, implantados e mantidos para cada plataforma de destino.
• Os aplicativos cliente nativos geralmente levam mais tempo para localizar, baixar e instalar ao acessar um aplicativo Web em um navegador.

Para obter mais informações, consulte ASP.NET Core Blazor Hybrid.

Para obter mais informações sobre estruturas de cliente nativo da Microsoft, consulte os seguintes recursos:

• .NET Multi-platform App UI (.NET MAUI)
• Fundação de Apresentação do Windows (WPF)
• Formulários do Windows

O modelo de hospedagem de um componente é definido por seu modo de renderização , seja em tempo de compilação ou tempo de execução, que é descrito com exemplos em ASP.NET modos de renderização Core Blazor. A tabela a seguir mostra as principais considerações para definir o modo de renderização para determinar o modelo de hospedagem de um componente. Para aplicativos Blazor WebAssembly autônomos, todos os componentes do aplicativo são renderizados no cliente com o modelo de hospedagem Blazor WebAssembly.

Selecione o modelo de hospedagem Blazor com base nos requisitos de recursos do aplicativo. A tabela a seguir mostra as principais considerações para selecionar o modelo de hospedagem.

Blazor Hybrid aplicações incluem aplicações da estrutura .NET MAUI, WPF e Windows Forms.

†Blazor WebAssembly e Blazor Hybrid aplicativos podem usar APIs baseadas em servidor para acessar recursos de servidor/rede e acessar código de aplicativo privado e seguro.
‡Blazor WebAssembly só atinge um desempenho quase nativo com compilação ahead-of-time (AOT).

†Blazor WebAssembly aplicativos podem usar APIs baseadas em servidor para acessar recursos de servidor/rede e acessar código de aplicativo privado e seguro.

Para criar uma aplicação Blazor Hybrid, consulte os artigos em ASP.NET Core tutoriais Blazor Hybrid.

Os componentes renderizados para o modelo de hospedagem Blazor Server e aplicativos Blazor Hybrid têm compatibilidade completa com a API do .NET, enquanto os componentes renderizados para Blazor WebAssembly são limitados a um subconjunto de APIs do .NET. Quando a especificação de um aplicativo exigir uma ou mais APIs .NET que não estão disponíveis para componentes renderizados pelo WebAssembly, opte por renderizar componentes para Blazor Server ou usar Blazor Hybrid.

Blazor Server e Blazor Hybrid aplicativos têm compatibilidade completa com a API .NET, enquanto os aplicativos Blazor WebAssembly são limitados a um subconjunto de APIs .NET. Quando a especificação de um aplicativo exigir uma ou mais APIs .NET que não estão disponíveis para Blazor WebAssembly aplicativos, escolha Blazor Server ou Blazor Hybrid.

Blazor Server aplicativos têm total compatibilidade com a API do .NET, enquanto os aplicativos Blazor WebAssembly são limitados a um subconjunto de APIs do .NET. Quando a especificação de uma aplicação requerer uma ou mais APIs .NET que não estão disponíveis para aplicações Blazor WebAssembly, escolha Blazor Server.

Os componentes renderizados para o modelo de hospedagem Blazor Server têm acesso direto aos recursos do servidor e da rede onde o aplicativo está sendo executado. Como os componentes hospedados usando Blazor WebAssembly ou Blazor Hybrid são executados em um cliente, eles não têm acesso direto aos recursos do servidor e da rede. Os componentes podem acessar recursos de servidor e rede indiretamente por meio de APIs protegidas baseadas em servidor. As APIs baseadas em servidor podem estar disponíveis por meio de bibliotecas, pacotes e serviços de terceiros. Tenha em conta as seguintes considerações:

• A implementação e manutenção de bibliotecas, pacotes e serviços de terceiros podem ser dispendiosos, ter um suporte fraco ou introduzir riscos de segurança.
• Se uma ou mais APIs baseadas em servidor forem desenvolvidas internamente pela sua organização, serão necessários recursos adicionais para criá-las e mantê-las.

Use o modelo de hospedagem Blazor Server para evitar a necessidade de expor APIs do ambiente de servidor.

Blazor Server aplicativos têm acesso direto aos recursos do servidor e da rede onde o aplicativo está sendo executado. Como Blazor WebAssembly e Blazor Hybrid aplicativos são executados em um cliente, eles não têm acesso direto aos recursos do servidor e da rede. Blazor WebAssembly e Blazor Hybrid aplicativos podem acessar recursos de servidor e rede indiretamente por meio de APIs protegidas baseadas em servidor. As APIs baseadas em servidor podem estar disponíveis por meio de bibliotecas, pacotes e serviços de terceiros. Tenha em conta as seguintes considerações:

• A implementação e manutenção de bibliotecas, pacotes e serviços de terceiros podem ser dispendiosos, ter um suporte fraco ou introduzir riscos de segurança.
• Se uma ou mais APIs baseadas em servidor forem desenvolvidas internamente pela sua organização, serão necessários recursos adicionais para criá-las e mantê-las.

Para evitar APIs baseadas em servidor para aplicativos Blazor WebAssembly ou Blazor Hybrid, adote Blazor Server, que pode acessar recursos de servidor e rede diretamente.

Blazor Server aplicativos têm acesso direto aos recursos do servidor e da rede onde o aplicativo está sendo executado. Como Blazor WebAssembly aplicativos são executados em um cliente, eles não têm acesso direto aos recursos do servidor e da rede. Blazor WebAssembly as aplicações podem aceder a recursos de servidores e redes indiretamente através de APIs protegidas baseadas em servidor. As APIs baseadas em servidor podem estar disponíveis por meio de bibliotecas, pacotes e serviços de terceiros. Tenha em conta as seguintes considerações:

• A implementação e manutenção de bibliotecas, pacotes e serviços de terceiros podem ser dispendiosos, ter um suporte fraco ou introduzir riscos de segurança.
• Se uma ou mais APIs baseadas em servidor forem desenvolvidas internamente pela sua organização, serão necessários recursos adicionais para criá-las e mantê-las.

Para evitar APIs baseadas em servidor para aplicativos Blazor WebAssembly, adote Blazor Server, que podem acessar recursos de servidor e rede diretamente.

A renderização de componentes do servidor reduz o tamanho da carga útil do aplicativo e melhora os tempos de carregamento iniciais. Quando um tempo de carregamento inicial rápido for desejado, use o modelo de hospedagem Blazor Server ou considere a renderização estática do lado do servidor.

As aplicações Blazor Server têm tamanhos de carga relativamente pequenos e tempos de carregamento inicial mais rápidos. Quando desejar um tempo de carregamento inicial rápido, adote Blazor Server.

Blazor Hybrid aplicações são executadas usando o .NET runtime nativamente na plataforma de destino, o que oferece a melhor velocidade possível.

Os componentes renderizados para o modelo de hospedagem Blazor WebAssembly, incluindo PWAs (Progressive Web Apps) e aplicativos Blazor WebAssembly autônomos são executados usando o tempo de execução do .NET para WebAssembly, que é mais lento do que a execução direta na plataforma. Considere o uso de compilado antecipadamente do tempo (AOT) para melhorar o desempenho do tempo de execução ao usar Blazor WebAssembly.

Blazor Hybrid aplicações são executadas usando o .NET runtime nativamente na plataforma de destino, o que oferece a melhor velocidade possível.

Blazor WebAssembly, incluindo Progressive Web Apps (PWAs), os aplicativos são executados usando o tempo de execução do .NET para WebAssembly, que é mais lento do que a execução direta na plataforma, mesmo para aplicativos que são antecipadamente compilados (AOT) para WebAssembly no navegador.

Blazor Server aplicativos geralmente são executados no servidor rapidamente.

Blazor WebAssembly aplicativos são executados usando o tempo de execução do .NET para WebAssembly, que é mais lento do que a execução direta na plataforma.

Manter o código do aplicativo de forma segura e privada no servidor é um recurso interno de componentes renderizados para o modelo de hospedagem Blazor Server. Os componentes renderizados usando os modelos de hospedagem Blazor WebAssembly ou Blazor Hybrid podem usar APIs baseadas em servidor para acessar funcionalidades que devem ser mantidas privadas e seguras. Aplicam-se as considerações para desenvolver e manter APIs baseadas em servidor descritas na seção Acesso direto ao servidor e aos recursos de rede. Se o desenvolvimento e a manutenção de APIs baseadas em servidor não forem desejáveis para manter o código seguro e privado do aplicativo, renderize componentes para o modelo de hospedagem Blazor Server.

Manter o código do aplicativo de forma segura e privada no servidor é um recurso interno do Blazor Server. Blazor WebAssembly e Blazor Hybrid aplicativos podem usar APIs baseadas em servidor para acessar funcionalidades que devem ser mantidas privadas e seguras. Aplicam-se as considerações para desenvolver e manter APIs baseadas em servidor descritas na seção Acesso direto ao servidor e aos recursos de rede. Se o desenvolvimento e a manutenção de APIs baseadas em servidor não forem desejáveis para manter o código de aplicativo seguro e privado, adote o modelo de hospedagem Blazor Server.

Manter o código do aplicativo de forma segura e privada no servidor é um recurso interno do Blazor Server. Blazor WebAssembly aplicativos podem usar APIs baseadas em servidor para acessar funcionalidades que devem ser mantidas privadas e seguras. Aplicam-se as considerações para desenvolver e manter APIs baseadas em servidor descritas na seção Acesso direto ao servidor e aos recursos de rede. Se o desenvolvimento e a manutenção de APIs baseadas em servidor não forem desejáveis para manter o código de aplicativo seguro e privado, adote o modelo de hospedagem Blazor Server.

Os aplicativos Blazor WebAssembly autônomos criados como aplicativos Web progressivos (PWAs) e aplicativos Blazor Hybrid podem ser executados offline, o que é particularmente útil quando os clientes não conseguem se conectar à Internet. Os componentes renderizados para o modelo de hospedagem Blazor Server não são executados quando a conexão com o servidor é perdida. Se um aplicativo precisar ser executado offline, Blazor WebAssembly e Blazor Hybrid autônomos são as melhores opções.

Blazor WebAssembly aplicativos criados como Progressive Web Apps (PWAs) e aplicativos Blazor Hybrid podem ser executados offline, o que é particularmente útil quando os clientes não conseguem se conectar à Internet. Blazor Server aplicativos não são executados quando a conexão com o servidor é perdida. Se um aplicativo precisar ser executado offline, Blazor WebAssembly e Blazor Hybrid são as melhores opções.

Blazor WebAssembly aplicativos podem ser executados offline, o que é particularmente útil quando os clientes não conseguem se conectar à Internet. Blazor Server aplicativos não são executados quando a conexão com o servidor é perdida. Se um aplicativo precisar ser executado offline, Blazor WebAssembly é a melhor escolha.

Embora as aplicações Blazor Hybrid sejam compiladas em um ou mais ativos de implementação autossuficientes, os ativos geralmente são fornecidos aos clientes através de uma loja de aplicações de terceiros. Se a hospedagem estática for um requisito do aplicativo, selecione Blazor WebAssemblyindependente.

Os componentes renderizados usando os modelos de hospedagem Blazor WebAssembly ou Blazor Hybrid são executados em clientes e, portanto, descarregam o processamento para os clientes. Os componentes renderizados para o modelo de hospedagem Blazor Server são executados em um servidor, de modo que a demanda de recursos do servidor normalmente aumenta com o número de usuários e a quantidade de processamento necessária por usuário. Quando é possível descarregar a maior parte ou todo o processamento de um aplicativo para clientes e o aplicativo processa uma quantidade significativa de dados, Blazor WebAssembly ou Blazor Hybrid é a melhor escolha.

Blazor WebAssembly e Blazor Hybrid aplicativos são executados em clientes e, portanto, descarregam o processamento para os clientes. Blazor Server aplicativos são executados em um servidor, portanto, a demanda de recursos do servidor normalmente aumenta com o número de usuários e a quantidade de processamento necessária por usuário. Quando é possível descarregar a maior parte ou todo o processamento de um aplicativo para clientes e o aplicativo processa uma quantidade significativa de dados, Blazor WebAssembly ou Blazor Hybrid é a melhor escolha.

Blazor WebAssembly aplicações são executadas em clientes e, portanto, transferem o processamento para os clientes. Blazor Server aplicativos são executados em um servidor, portanto, a demanda de recursos do servidor normalmente aumenta com o número de usuários e a quantidade de processamento necessária por usuário. Quando é possível descarregar a maior parte ou todo o processamento de um aplicativo para clientes e o aplicativo processa uma quantidade significativa de dados, Blazor WebAssembly é a melhor escolha.

Acesso total aos recursos nativos do cliente

Blazor Hybrid aplicativos têm acesso total aos recursos nativos da API do cliente por meio de estruturas de aplicativos nativos do .NET. Em aplicações Blazor Hybrid, os componentes Razor funcionam diretamente na aplicação nativa, não no WebAssembly. Quando os recursos completos do cliente são um requisito, Blazor Hybrid é a melhor escolha.

Blazor Hybrid aplicativos são aplicativos cliente nativos que normalmente exigem um instalador e um mecanismo de implantação específico da plataforma.

Definindo o modelo de hospedagem de um componente

Para definir o modelo de hospedagem de um componente como Blazor Server ou Blazor WebAssembly em tempo de compilação ou dinamicamente em tempo de execução, defina seu modo de renderização . Os modos de renderização são totalmente explicados e demonstrados no ASP.NET Core Blazor modos de renderização artigo. Não recomendamos que salte deste artigo diretamente para o artigo modos de renderização sem ler o conteúdo dos artigos entre eles. Por exemplo, os modos de renderização são mais facilmente compreendidos ao examinar exemplos de componentes Razor, mas a estrutura e a função básicas do componente Razor só são tratadas quando se chega ao artigo sobre fundamentos do ASP.NET Core Blazor. Também é útil aprender sobre os modelos de projeto e as ferramentas do antes de trabalhar com os exemplos de componentes no artigo Modos de renderização .