Среды ASP.NET Core Blazor

В этой статье объясняется, как настроить и прочитать среду в Blazor приложении.

При локальном запуске приложения среда по умолчанию имеет значение Development. При публикации приложения среда по умолчанию имеет значение Production.

Рекомендуется использовать следующие соглашения:

• Всегда используйте имя среды "Development" для локальной разработки. Это связано с тем, что платформа ASP.NET Core ожидает именно это имя при настройке приложения и инструментов для локальных запусков разработки приложения.

• Для тестирования, промежуточной и рабочей среды всегда публикуйте и развертывайте приложение. Вы можете использовать любую схему именования среды, которую вы хотите использовать для опубликованных приложений, но всегда используйте имена файлов параметров приложения с регистром сегмента среды, который точно соответствует имени среды. Для промежуточного выполнения используйте "Staging" ("S" ("") в качестве имени среды и присвойте файлу параметров приложения для сопоставления (appsettings.Staging.json). Для рабочей среды используйте "Production" ("" ("P") в качестве имени среды и назовите файл параметров приложения для сопоставления (appsettings.Production.json).

Указание среды

Для автономного Blazor WebAssembly приложения, работающего локально, сервер разработки добавляет blazor-environment заголовок.

Для локального запуска приложения в разработке приложение по умолчанию использует Development среду. Публикация приложения по умолчанию использует среду Production.

Настройка клиентской среды с помощью Blazor конфигурации запуска

В приведенном ниже примере Blazor запускается в среде Staging, если в имени узла содержится localhost. В противном случае среда имеет значение по умолчанию.

<script src="{BLAZOR SCRIPT}" autostart="false"></script>
<script>
  if (window.location.hostname.includes("localhost")) {
    Blazor.start({
      webAssembly: {
        environment: "Staging"
      }
    });
  } else {
    Blazor.start();
  }
</script>

<script src="{BLAZOR SCRIPT}" autostart="false"></script>
<script>
  if (window.location.hostname.includes("localhost")) {
    Blazor.start({
      environment: "Staging"
    });
  } else {
    Blazor.start();
  }
</script>

В предыдущем примере {BLAZOR SCRIPT} заполнитель — это путь к скрипту Blazor и имя файла. Сведения о расположении скрипта см. в разделе ASP.NET Структура проекта CoreBlazor.

Использование свойства environment переопределяет среду, заданную заголовком blazor-environment.

Предыдущий подход задает среду клиента без изменения blazor-environment значения заголовка, а также не изменяет ведение журнала консоли проекта сервера для среды запуска для Blazor Web App глобальной интерактивной веб-страницы webAssembly.

Чтобы записать среду в консоль в автономном Blazor WebAssembly проекте или .Client проекте проекта Blazor Web App, поместите следующий код C# в Program файл после WebAssemblyHost создания WebAssemblyHostBuilder.CreateDefault и перед строкой, которая создает и запускает проект (await builder.Build().RunAsync();):

Console.WriteLine(
    $"Client Hosting Environment: {builder.HostEnvironment.Environment}");

Дополнительные сведения о запуске Blazor см. в статье Запуск ASP.NET Core Blazor.

Настройка клиентской среды с помощью заголовка

Blazor WebAssembly приложения могут задать среду с заголовком blazor-environment .

В приведенном ниже примере для служб IIS пользовательский заголовок (blazor-environment) добавляется в опубликованный файл web.config. Файл web.config находится в папке bin/Release/{TARGET FRAMEWORK}/publish , где {TARGET FRAMEWORK} заполнитель является целевой платформой:

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>

    ...

    <httpProtocol>
      <customHeaders>
        <add name="blazor-environment" value="Staging" />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</configuration>

Задание среды для Службы приложений Azure

Для автономного Blazor WebAssembly приложения можно вручную задать среду с помощью конфигурации запуска или заголовкаblazor-environment.

Для серверного приложения настройте среду с помощью ASPNETCORE_ENVIRONMENT параметра приложения в Azure:

1. Убедитесь, что регистр сегментов среды в именах файлов параметров приложения точно совпадают с регистром имени среды. Например, совпадающее имя файла параметров приложения для Staging среды appsettings.Staging.json. Если имя файла — appsettings.staging.json (строчная буква "s"), файл не расположен, а параметры в файле не используются в Staging среде.

2. Для развертывания Visual Studio убедитесь, что приложение развернуто в нужном слоте. Для приложения с именем BlazorAzureAppSample приложение развертывается в слоте развертывания Staging.

3. На портале Azure в слоте развертывания среды задайте среду с параметром приложения ASPNETCORE_ENVIRONMENT. Для приложения с именем BlazorAzureAppSample промежуточный слот Службы приложений называется BlazorAzureAppSample/Staging. Для конфигурации слота Staging создайте параметр приложения ASPNETCORE_ENVIRONMENT со значением Staging. Параметр слота развертывания включен для параметра.

При запросе в браузере приложение BlazorAzureAppSample/Staging загружается в среду Staging в https://blazorazureappsample-staging.azurewebsites.net.

При загрузке приложения в браузере коллекция заголовков ответа для blazor.boot.json указывает, что значение заголовка blazor-environment — Staging.

Параметры приложения из файла appsettings.{ENVIRONMENT}.json загружаются приложением, где заполнитель {ENVIRONMENT} — это среда приложения. В предыдущем примере загружаются параметры из файла appsettings.Staging.json.

Чтение среды в Blazor WebAssembly приложении

Чтобы получить среду приложения в компоненте, вставьте IWebAssemblyHostEnvironment и прочтите свойство Environment.

ReadEnvironment.razor:

@page "/read-environment"
@using Microsoft.AspNetCore.Components.WebAssembly.Hosting
@inject IWebAssemblyHostEnvironment Env

<h1>Environment example</h1>

<p>Environment: @Env.Environment</p>

using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
using Microsoft.AspNetCore.Components;

public class ServerHostEnvironment(IWebHostEnvironment env, NavigationManager nav) : 
    IWebAssemblyHostEnvironment
{
    public string Environment => env.EnvironmentName;
    public string BaseAddress => nav.BaseUri;
}

builder.Services.TryAddScoped<IWebAssemblyHostEnvironment, ServerHostEnvironment>();

Чтение клиентской среды во время запуска

Во время запуска WebAssemblyHostBuilder предоставляет IWebAssemblyHostEnvironment с помощью свойства HostEnvironment, которое позволяет реализовать в коде построителя узлов логику для конкретной среды.

В файле Program:

if (builder.HostEnvironment.Environment == "Custom")
{
    ...
};

Следующие удобные методы расширения, предоставляемые через WebAssemblyHostEnvironmentExtensions, допускают проверку текущей среды на признак Development (среды разработки), Production (среды тестирования), Staging (коммерческой среды) или пользовательской среды.

• IsDevelopment
• IsProduction
• IsStaging
• IsEnvironment

В файле Program:

if (builder.HostEnvironment.IsStaging())
{
    ...
};

if (builder.HostEnvironment.IsEnvironment("Custom"))
{
    ...
};

Свойство IWebAssemblyHostEnvironment.BaseAddress можно использовать во время запуска, если служба NavigationManager недоступна.

Дополнительные ресурсы

• Запуск BlazorASP.NET Core
• Использование нескольких сред в ASP.NET Core
• Blazorпримеры репозитория GitHub (dotnet/blazor-samplesкак скачать)