file statis ASP.NET Core Blazor

Artikel ini menjelaskan Blazor konfigurasi aplikasi untuk menyajikan file statis.

Middleware aset statis

Bagian ini berlaku untuk aplikasi sisi Blazor server.

Konfigurasikan Middleware File Statis untuk melayani aset statis kepada klien dengan memanggil UseStaticFiles dalam alur pemrosesan permintaan aplikasi. Untuk informasi selengkapnya, lihat File statis di ASP.NET Core.

Dalam rilis sebelum .NET 8, Blazor file statis kerangka kerja, seperti Blazor skrip, disajikan melalui Middleware File Statis. Di .NET 8 atau yang lebih baru, Blazor file statis kerangka kerja dipetakan menggunakan perutean titik akhir, dan Middleware File Statis tidak lagi digunakan.

Mode Proyek Aset Web Statis

Bagian ini berlaku untuk .Client proyek Blazor Aplikasi Web.

Pengaturan yang Blazor diperlukan <StaticWebAssetProjectMode>Default</StaticWebAssetProjectMode> dalam .Client proyek Aplikasi Web mengembalikan Blazor WebAssembly perilaku aset statis kembali ke default, sehingga proyek berulah sebagai bagian dari proyek yang dihosting. Blazor WebAssembly SDK (Microsoft.NET.Sdk.BlazorWebAssembly) mengonfigurasi aset web statis dengan cara tertentu untuk bekerja dalam mode "mandiri" dengan server hanya menggunakan output dari pustaka. Ini tidak sesuai untuk Blazor Aplikasi Web, di mana bagian WebAssembly dari aplikasi adalah bagian logis dari host dan harus berulah lebih seperti pustaka. Misalnya, proyek tidak mengekspos bundel gaya (misalnya, BlazorSample.Client.styles.css) dan sebaliknya hanya menyediakan host dengan bundel proyek, sehingga host dapat menyertakannya dalam bundel gayanya sendiri.

Mengubah nilai (Default) <StaticWebAssetProjectMode> atau menghapus properti dari .Client proyek tidak didukung.

File statis di lingkungan non-Development

Bagian ini berlaku untuk file statis sisi server.

Saat menjalankan aplikasi secara lokal, aset web statis hanya diaktifkan secara default di Development lingkungan. Untuk mengaktifkan file statis untuk lingkungan selain Development selama pengembangan dan pengujian lokal (misalnya, Staging), panggil UseStaticWebAssets di WebApplicationBuilder dalam Program file.

Peringatan

Panggil UseStaticWebAssets lingkungan yang tepat untuk mencegah mengaktifkan fitur dalam produksi, karena melayani file dari lokasi terpisah pada disk selain dari proyek jika dipanggil di lingkungan produksi. Contoh di bagian ini memeriksa Staging lingkungan dengan memanggil IsStaging.

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

Awalan untuk Blazor WebAssembly aset

Bagian ini berlaku untuk Blazor Web Apps.

WebAssemblyComponentsEndpointOptions.PathPrefix Gunakan opsi titik akhir untuk mengatur string jalur yang menunjukkan awalan untuk Blazor WebAssembly aset. Jalur harus sesuai dengan proyek aplikasi yang dirujuk Blazor WebAssembly .

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

Dalam contoh sebelumnya, {PATH PREFIX} tempat penampung adalah awalan jalur dan harus dimulai dengan garis miring (/).

Dalam contoh berikut, awalan jalur diatur ke /path-prefix:

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

Jalur dasar aset web statis

Bagian ini berlaku untuk aplikasi mandiri Blazor WebAssembly .

Secara default, menerbitkan aplikasi menempatkan aset statis aplikasi, termasuk Blazor file kerangka kerja (_framework aset folder), di jalur akar (/) dalam output yang diterbitkan. <StaticWebAssetBasePath> Properti yang ditentukan dalam file proyek (.csproj) mengatur jalur dasar ke jalur non-akar:

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

Dalam contoh sebelumnya, {PATH} tempat penampung adalah jalurnya.

Tanpa mengatur <StaticWebAssetBasePath> properti, aplikasi mandiri diterbitkan di /BlazorStandaloneSample/bin/Release/{TFM}/publish/wwwroot/.

Dalam contoh sebelumnya, {TFM} tempat penampung adalah Target Framework Moniker (TFM) (misalnya, net6.0).

<StaticWebAssetBasePath> Jika properti dalam aplikasi mandiri Blazor WebAssembly mengatur jalur aset statis yang diterbitkan ke app1, jalur akar ke aplikasi dalam output yang diterbitkan adalah /app1.

Dalam file proyek aplikasi mandiri Blazor WebAssembly (.csproj):

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

Dalam output yang diterbitkan, jalur ke aplikasi mandiri Blazor WebAssembly adalah /BlazorStandaloneSample/bin/Release/{TFM}/publish/wwwroot/app1/.

Dalam contoh sebelumnya, {TFM} tempat penampung adalah Target Framework Moniker (TFM) (misalnya, net6.0).

Pemetaan file dan opsi file statis

Bagian ini berlaku untuk file statis sisi server.

Untuk membuat pemetaan file tambahan dengan FileExtensionContentTypeProvider atau mengonfigurasi yang lain StaticFileOptions, gunakan salah satu pendekatan berikut. Dalam contoh berikut, {EXTENSION} tempat penampung adalah ekstensi file, dan {CONTENT TYPE} tempat penampung adalah jenis konten. Namespace untuk API berikut adalah Microsoft.AspNetCore.StaticFiles.

• Konfigurasikan opsi melalui injeksi dependensi (DI) dalam Program file menggunakan StaticFileOptions:

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

• Teruskan StaticFileOptions langsung ke UseStaticFilesProgram dalam file:

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

Sumber Daya Tambahan:

Jalur dasar aplikasi