Startup aplikasi di ASP.NET Core

Oleh Rick Anderson

Aplikasi ASP.NET Core yang dibuat dengan template web berisi kode pengaktifan aplikasi dalam file Program.cs.

Untuk Blazor panduan startup, yang menambahkan atau menggantikan panduan dalam artikel ini, lihat startup ASP.NET CoreBlazor.

Kode startup aplikasi berikut mendukung:

• Razor Pages
• Pengontrol MVC dengan tampilan
• API Web dengan pengontrol
• API minimal

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
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.Run();

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

Untuk informasi selengkapnya tentang pengaktifan aplikasi, lihat gambaran umum dasar-dasar ASP.NET Core.

Perluas Startup dengan filter 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 alur Configure metode. IStartupFilter.Configure dapat mengatur middleware untuk dijalankan sebelum atau sesudah middleware ditambahkan oleh pustaka.

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

Masing-masing 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 menetapkan nilai opsi dari parameter string 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 :

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

IStartupFilter terdaftar di 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 IStartupFilter implementasi dapat berinteraksi dengan objek yang sama. Jika pemesanan penting, pesan pendaftaran layanan mereka IStartupFilter agar sesuai dengan urutan yang harus dijalankan middleware mereka.

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

  • Posisikan pendaftaran layanan sebelum pustaka ditambahkan ke kontainer layanan.
  • Untuk memanggil setelahnya, posisikan pendaftaran layanan setelah pustaka ditambahkan.

Catatan: Anda tidak dapat memperluas aplikasi ASP.NET Core saat mengambil alih Configure. Untuk informasi selengkapnya, lihat masalah GitHub ini.

Menambahkan konfigurasi saat startup dari rakitan eksternal

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

Memulai, MengonfigurasiServices, dan Mengonfigurasi

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

• Menggunakan Startup dengan model hosting minimal
• Versi ASP.NET Core 5.0 dari artikel ini:
  • Metode ConfigureServices
  • Metode Konfigurasi