Blazor základní prostředí ASP.NET

Tento článek vysvětluje, jak nakonfigurovat a přečíst prostředí v Blazor aplikaci.

Při místním spuštění aplikace se ve výchozím nastavení prostředí nastaví na Developmenthodnotu . Když je aplikace publikovaná, prostředí se ve výchozím nastavení nastaví na Production.

Doporučujeme následující konvence:

• Pro místní vývoj vždy používejte název prostředí "Development". Důvodem je to, že architektura ASP.NET Core očekává přesně tento název při konfiguraci aplikace a nástrojů pro místní vývoj aplikací.

• Pro testování, přípravu a produkční prostředí vždy publikujte a nasaďte aplikaci. Můžete použít jakékoli schéma pojmenování prostředí, které chcete publikovat aplikace, ale vždy použijte názvy souborů nastavení aplikace s písmenem segmentu prostředí, který přesně odpovídá názvu prostředí. Pro přípravu použijte jako název prostředí "Staging" (velkáS "") a soubor nastavení aplikace pojmenujte tak, aby odpovídal (appsettings.Staging.json). V produkčním prostředí použijte jako název prostředí "Production" (kapitálP) a pojmenujte soubor nastavení aplikace, který se má shodovat (appsettings.Production.json).

Nastavení prostředí

Pro samostatnou Blazor WebAssembly aplikaci spuštěnou místně přidá vývojový server hlavičku blazor-environment .

V případě, že aplikace běží místně ve vývoji, je výchozí Development pro dané prostředí. Publikování aplikace ve výchozím nastavení prostředí na Production.

Nastavení prostředí na straně klienta prostřednictvím Blazor konfigurace spuštění

Následující příklad začíná Blazor v Staging prostředí, pokud název hostitele obsahuje localhost. V opačném případě je prostředí nastaveno na výchozí hodnotu.

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

V předchozím příkladu {BLAZOR SCRIPT} je Blazor zástupný symbol cesta ke skriptu a název souboru. Umístění skriptu najdete v tématu ASP.NET Blazor Základní struktura projektu.

environment Použití vlastnosti přepíše prostředí nastavené hlavičkoublazor-environment.

Předchozí přístup nastaví prostředí klienta beze změny blazor-environment hodnoty hlavičky, ani nezmění protokolování konzoly projektu serveru pro spouštěcí prostředí pro Blazor Web App prostředí, které přijalo globální interaktivní vykreslování WebAssembly.

Pokud chcete prostředí protokolovat do konzoly v samostatném Blazor WebAssembly projektu nebo .Client projektu , Blazor Web Appumístěte následující kód jazyka C# do Program souboru po WebAssemblyHost vytvoření WebAssemblyHostBuilder.CreateDefault a před řádek, který sestaví a spustí projekt (await builder.Build().RunAsync();):

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

Další informace o spuštění architektury Blazor najdete v tématu Spuštění ASP.NET Core Blazor.

Nastavení prostředí na straně klienta prostřednictvím hlavičky

Blazor WebAssembly aplikace můžou prostředí nastavit pomocí hlavičky blazor-environment .

V následujícím příkladu služby IIS se vlastní hlavička (blazor-environment) přidá do publikovaného web.config souboru. Soubor web.config se nachází ve bin/Release/{TARGET FRAMEWORK}/publish složce, kde {TARGET FRAMEWORK} zástupný symbol představuje cílovou architekturu:

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

    ...

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

Nastavení prostředí pro službu Aplikace Azure Service

Pro samostatnou Blazor WebAssembly aplikaci můžete prostředí nastavit ručně prostřednictvím konfigurace spuštění nebo hlavičkyblazor-environment.

V případě aplikace na straně serveru nastavte prostředí prostřednictvím ASPNETCORE_ENVIRONMENT nastavení aplikace v Azure:

1. Ověřte, že velikost písmen segmentů prostředí v názvech souborů nastavení aplikace odpovídá velikostí písmen jejich názvů prostředí. Například odpovídající název souboru nastavení aplikace pro Staging prostředí je appsettings.Staging.json. Pokud je appsettings.staging.json název souboru (malými písmenys), soubor se nenachází a nastavení v souboru se v Staging prostředí nepoužívá.

2. V případě nasazení sady Visual Studio ověřte, že je aplikace nasazená do správného slotu nasazení. U aplikace s názvem BlazorAzureAppSamplese aplikace nasadí do slotu Staging nasazení.

3. Na webu Azure Portal pro slot nasazení prostředí nastavte prostředí s ASPNETCORE_ENVIRONMENT nastavením aplikace. Pro aplikaci s názvem BlazorAzureAppSamplemá pracovní slot služby App Service název BlazorAzureAppSample/Staging. Pro konfiguraci slotu Staging vytvořte nastavení ASPNETCORE_ENVIRONMENT aplikace s hodnotou Staging. Nastavení slotu nasazení je pro nastavení povolené.

Po vyžádání v prohlížeči se BlazorAzureAppSample/Staging aplikace načte v Staging prostředí na adrese https://blazorazureappsample-staging.azurewebsites.net.

Když se aplikace načte v prohlížeči, kolekce blazor.boot.json hlaviček odpovědí značí, že blazor-environment hodnota hlavičky je Staging.

Nastavení aplikace ze appsettings.{ENVIRONMENT}.json souboru se načte aplikací, kde {ENVIRONMENT} zástupný symbol představuje prostředí aplikace. V předchozím příkladu se načtou appsettings.Staging.json nastavení ze souboru.

Čtení prostředí v Blazor WebAssembly aplikaci

Získejte prostředí aplikace v komponentě vložením IWebAssemblyHostEnvironment a přečtením Environment vlastnosti.

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

Čtení prostředí na straně klienta během spouštění

Během spuštění WebAssemblyHostBuilder zpřístupňuje IWebAssemblyHostEnvironment HostEnvironment prostřednictvím vlastnosti, která umožňuje logiku specifickou pro prostředí v kódu tvůrce hostitelů.

V souboru Program:

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

Následující metody rozšíření pohodlí poskytované prostřednictvím WebAssemblyHostEnvironmentExtensions kontroly aktuálního prostředí pro Development, ProductionStaging, a vlastní názvy prostředí:

• IsDevelopment
• IsProduction
• IsStaging
• IsEnvironment

V souboru Program:

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

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

Vlastnost IWebAssemblyHostEnvironment.BaseAddress lze použít při spuštění, NavigationManager pokud služba není k dispozici.

Další materiály

• spuštění ASP.NET Core Blazor
• Používání více prostředí v ASP.NET Core
• Blazorukázky úložiště GitHub () (dotnet/blazor-samplespostup stažení)