ASP.NET základních Blazor statických souborů

Tento článek popisuje Blazor konfiguraci aplikace pro obsluhu statických souborů.

Middleware statického prostředku

Tato část se týká aplikací na straně Blazor serveru.

Nakonfigurujte Middleware statického souboru tak, aby klientům sloužil statickým prostředkům voláním UseStaticFiles v kanálu zpracování požadavků aplikace. Další informace najdete v tématu Statické soubory v ASP.NET Core.

Ve verzích před rozhraním .NET 8 Blazor se statické soubory architektury, jako je skript, obsluhují prostřednictvím statického middlewaru Blazor souborů. V .NET 8 nebo novějších Blazor se statické soubory architektury mapují pomocí směrování koncového bodu a statický middleware se už nepoužívá.

Režim projektu statického webového assetu

Tato část se týká .Client projektu Blazor webové aplikace.

Požadované <StaticWebAssetProjectMode>Default</StaticWebAssetProjectMode> nastavení v .Client projektu webové aplikace vrátí Blazor WebAssembly chování statických Blazor prostředků zpět na výchozí hodnoty, aby se projekt chová jako součást hostovaného projektu. Sada Blazor WebAssembly SDK (Microsoft.NET.Sdk.BlazorWebAssembly) konfiguruje statické webové prostředky určitým způsobem tak, aby fungovala v samostatném režimu se serverem, který jednoduše využívá výstupy z knihovny. To není vhodné pro Blazor webovou aplikaci, kde je část aplikace WebAssembly logická část hostitele a musí se chovat podobně jako knihovna. Projekt například nezpřístupňuje sadu stylů (například BlazorSample.Client.styles.css) a místo toho poskytuje hostiteli pouze sadu projektů, aby ji hostitel mohl zahrnout do vlastní sady stylů.

Změna hodnoty (Default) nebo odebrání vlastnosti z .Client projektu není podporována.<StaticWebAssetProjectMode>

Statické soubory v jiných prostředíchDevelopment

Tato část se týká statických souborů na straně serveru.

Při místním spuštění aplikace jsou statické webové prostředky povoleny pouze ve výchozím nastavení v Development prostředí. Pokud chcete povolit statické soubory pro jiná prostředí než Development při místním vývoji a testování (například Staging), zavolejte UseStaticWebAssetsWebApplicationBuilder v Program souboru.

Upozorňující

Zavolejte UseStaticWebAssets přesné prostředí, aby se zabránilo aktivaci funkce v produkčním prostředí, protože obsluhuje soubory z jiných umístění na disku než z projektu, pokud je volána v produkčním prostředí. Příklad v této části kontroluje Staging prostředí voláním IsStaging.

if (builder.Environment.IsStaging())
{
    builder.WebHost.UseStaticWebAssets();
}

Předpona pro Blazor WebAssembly prostředky

Tato část platí pro Blazor Web Apps.

Pomocí možnosti koncového WebAssemblyComponentsEndpointOptions.PathPrefix bodu nastavte řetězec cesty, který označuje předponu prostředků Blazor WebAssembly . Cesta musí odpovídat odkazovanému Blazor WebAssembly projektu aplikace.

endpoints.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode(options => 
        options.PathPrefix = "{PATH PREFIX}");

V předchozím příkladu {PATH PREFIX} je zástupný symbol předponou cesty a musí začínat lomítkem (/).

V následujícím příkladu je předpona cesty nastavena na /path-prefix:

endpoints.MapRazorComponents<App>()
    .AddInteractiveWebAssemblyRenderMode(options => 
        options.PathPrefix = "/path-prefix");

Základní cesta statického webového prostředku

Tato část se týká samostatných Blazor WebAssembly aplikací.

Ve výchozím nastavení publikování aplikace umístí statické prostředky aplikace, včetně Blazor souborů architektury (_framework prostředků složek), do kořenové cesty (/) v publikovaném výstupu. Vlastnost <StaticWebAssetBasePath> zadaná v souboru projektu (.csproj) nastaví základní cestu k jiné než kořenové cestě:

<PropertyGroup>
  <StaticWebAssetBasePath>{PATH}</StaticWebAssetBasePath>
</PropertyGroup>

V předchozím příkladu {PATH} je zástupný symbol cestou.

Bez nastavení <StaticWebAssetBasePath> vlastnosti se publikuje samostatná aplikace na adrese /BlazorStandaloneSample/bin/Release/{TFM}/publish/wwwroot/.

V předchozím příkladu {TFM} je zástupný symbol Moniker (TFM) cílového rozhraní (například net6.0).

<StaticWebAssetBasePath> Pokud vlastnost v samostatné Blazor WebAssembly aplikaci nastaví publikovanou cestu statického prostředku na app1, kořenová cesta k aplikaci v publikovaném výstupu je /app1.

V souboru projektu samostatné Blazor WebAssembly aplikace (.csproj):

<PropertyGroup>
  <StaticWebAssetBasePath>app1</StaticWebAssetBasePath>
</PropertyGroup>

V publikovaném výstupu je /BlazorStandaloneSample/bin/Release/{TFM}/publish/wwwroot/app1/cesta k samostatné Blazor WebAssembly aplikaci .

V předchozím příkladu {TFM} je zástupný symbol Moniker (TFM) cílového rozhraní (například net6.0).

Mapování souborů a možnosti statického souboru

Tato část se týká statických souborů na straně serveru.

Pokud chcete vytvořit další mapování souborů s jiným StaticFileOptionssouborem nebo ho FileExtensionContentTypeProvider nakonfigurovat, použijte jeden z následujících přístupů. V následujících příkladech {EXTENSION} je zástupným symbolem přípona souboru a {CONTENT TYPE} zástupným symbolem je typ obsahu. Obor názvů pro následující rozhraní API je Microsoft.AspNetCore.StaticFiles.

• Konfigurace možností prostřednictvím injektáže závislostí (DI) v Program souboru pomocí StaticFileOptions:

  var provider = new FileExtensionContentTypeProvider();
  provider.Mappings["{EXTENSION}"] = "{CONTENT TYPE}";
  
  builder.Services.Configure<StaticFileOptions>(options =>
  {
      options.ContentTypeProvider = provider;
  });
  
  app.UseStaticFiles();
  

• StaticFileOptions Předat přímo do UseStaticFilesProgram souboru:

  var provider = new FileExtensionContentTypeProvider();
  provider.Mappings["{EXTENSION}"] = "{CONTENT TYPE}";
  
  app.UseStaticFiles(new StaticFileOptions { ContentTypeProvider = provider });
  

Další materiály

Základní cesta aplikace