Startup aplikasi di ASP.NET Core

Oleh Rick Anderson

ASP.NET Core aplikasi yang dibuat dengan templat web berisi kode startup aplikasi di file Program.cs.

Untuk Blazor panduan startup, yang menambahkan atau menggantikan panduan di artikel ini, lihat ASP.NET Core Blazor startup.

Kode startup aplikasi berikut mendukung beberapa jenis aplikasi:

• Blazor Web AppS
• Razor Halaman
• Pengontrol MVC dengan tampilan
• API Web dengan pengontrol
• API minimal

using WebAll.Components;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents();
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseAuthorization();

app.MapGet("/hi", () => "Hello!");

app.MapDefaultControllerRoute();
app.MapRazorPages();

app.MapRazorComponents<App>()
    .AddInteractiveServerRenderMode();

app.UseAntiforgery();

app.Run();

Aplikasi yang menggunakan EventSource dapat mengukur waktu startup untuk memahami dan mengoptimalkan performa startup. Peristiwa ServerReady dalam Microsoft.AspNetCore.Hosting mewakili titik di mana server siap merespons permintaan.

Perluas Startup dengan penyaring startup

Gunakan IStartupFilter:

• Untuk mengonfigurasi middleware di awal atau akhir alur middleware aplikasi tanpa panggilan eksplisit ke Use{Middleware}. Gunakan IStartupFilter untuk menambahkan default ke awal alur tanpa secara eksplisit mendaftarkan middleware default. IStartupFilter memungkinkan komponen yang berbeda untuk memanggil Use{Middleware} atas nama penulis aplikasi.

• Untuk membuat jalur metode Configure. IStartupFilter.Configure dapat mengatur middleware untuk dijalankan sebelum atau sesudah middleware yang ditambahkan oleh kode library.

Implementasi IStartupFilter menyediakan Configure metode yang menerima dan mengembalikan Action<IApplicationBuilder>. Menentukan IApplicationBuilder kelas untuk mengonfigurasi alur permintaan aplikasi. Untuk informasi selengkapnya, lihat Membuat alur middleware dengan IApplicationBuilder.

Setiap implementasi IStartupFilter dapat menambahkan satu atau beberapa middleware dalam alur permintaan. Filter dipanggil dalam urutan ditambahkan ke kontainer layanan. Filter dapat menambahkan middleware sebelum atau sesudah meneruskan kontrol ke filter berikutnya, sehingga ditambahkan ke awal atau akhir alur aplikasi.

Contoh berikut menunjukkan cara mendaftarkan middleware dengan IStartupFilter. Middleware RequestSetOptionsMiddleware mengatur nilai opsi dari parameter kueri.

public class RequestSetOptionsMiddleware
{
    private readonly RequestDelegate _next;

    public RequestSetOptionsMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // Test with https://localhost:5001/Privacy/?option=Hello
    public async Task Invoke(HttpContext httpContext)
    {
        var option = httpContext.Request.Query["option"];

        if (!string.IsNullOrWhiteSpace(option))
        {
            httpContext.Items["option"] = WebUtility.HtmlEncode(option);
        }

        await _next(httpContext);
    }
}

dikonfigurasi RequestSetOptionsMiddleware di RequestSetOptionsStartupFilter kelas :

public class RequestSetOptionsStartupFilter : IStartupFilter
{
    public Action<IApplicationBuilder> Configure(Action<IApplicationBuilder> next)
    {
        return builder =>
        {
            builder.UseMiddleware<RequestSetOptionsMiddleware>();
            next(builder);
        };
    }
}

Implementasi IStartupFilter terdaftar dalam file Program.cs :

using WebStartup.Middleware;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddTransient<IStartupFilter,
                      RequestSetOptionsStartupFilter>();

var app = builder.Build();

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Saat parameter string kueri untuk option disediakan, middleware memproses penetapan nilai sebelum middleware ASP.NET Core merender respons:

@page
@model PrivacyModel
@{
    ViewData["Title"] = "Privacy Policy";
}
<h1>@ViewData["Title"]</h1>

<p> Append query string ?option=hello</p>
Option String: @HttpContext.Items["option"];

Urutan eksekusi middleware ditetapkan oleh urutan IStartupFilter pendaftaran:

• Beberapa implementasi IStartupFilter mungkin berinteraksi dengan objek yang sama. Jika pemesanan penting, pesan pendaftaran layanan mereka IStartupFilter agar sesuai dengan urutan yang harus dijalankan middleware mereka.

• Perpustakaan dapat menambahkan middleware dengan satu atau beberapa implementasi IStartupFilter yang berjalan sebelum atau setelah middleware aplikasi lain yang terdaftar di IStartupFilter. Untuk memanggil IStartupFilter middleware sebelum middleware ditambahkan oleh pustaka IStartupFilter:

  • Posisikan pendaftaran layanan sebelum pustaka ditambahkan ke kontainer layanan.

  • Untuk memanggil selanjutnya, posisikan registrasi layanan setelah pustaka ditambahkan.

Anda tidak dapat memperluas aplikasi ASP.NET Core ketika mengganti Configure. Untuk informasi selengkapnya, lihat GitHub /dotnet/aspnetcore/issues #45372.

Penambahan konfigurasi pada saat startup dari komponen eksternal

Implementasi IHostingStartup memungkinkan penambahan penyempurnaan ke aplikasi saat startup dari rakitan eksternal di luar file Program.cs aplikasi. Untuk informasi selengkapnya, lihat Menggunakan rakitan startup hosting di ASP.NET Core.

Startup, Mengonfigurasi Layanan, dan Mengonfigurasi

Untuk informasi tentang penggunaan metode ConfigureServices dan Configure dengan model hosting minimal, lihat:

• Menggunakan Startup dengan model hosting minimal
• Kelas Startup (.NET 5 versi artikel ini):
  • Metode ConfigureServices
  • Metode Konfigurasi

Konten terkait

• gambaran umum dasar-dasar ASP.NET Core
• Konfigurasi di ASP.NET Core