ASP.NET Core에서 앱 시작

작성자: Rick Anderson

웹 템플릿으로 만든 ASP.NET Core 앱은 Program.cs 파일에 애플리케이션 시작 코드를 포함합니다.

Blazor 이 문서의 지침을 추가하거나 대체하는 시작 지침은 ASP.NET Core Blazor 시작을 참조하세요.

다음 앱 시작 코드는 다음을 지원합니다.

• Razor Pages
• 보기가 있는 MVC 컨트롤러
• 컨트롤러가 있는 Web API
• 최소 API

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

EventSource를 사용하는 앱은 시작 시간을 측정하여 시작 성능을 이해하고 최적화할 수 있습니다. Microsoft.AspNetCore.Hosting의 ServerReady 이벤트는 서버가 요청에 응답할 준비가 된 지점을 나타냅니다.

애플리케이션 시작에 대한 자세한 내용은 ASP.NET Core 기본 사항 개요를 참조하세요.

시작 필터로 시작 확장

IStartupFilter는 다음 용도로 사용합니다.

• 명시적 호출 없이 앱 미들웨어 파이프라인의 시작 또는 끝에서 미들웨어를 구성하려면 Use{Middleware}. 기본 미들웨어를 명시적으로 등록하지 않고 파이프라인의 시작 부분에 기본값을 추가하는 데 사용합니다 IStartupFilter . IStartupFilter는 다른 구성 요소가 앱 작성자를 대신하여 Use{Middleware}를 호출하는 것을 허용합니다.
• Configure 메서드의 파이프라인을 만듭니다. IStartupFilter.Configure는 라이브러리에서 추가된 미들웨어 이전 또는 이후에 실행할 미들웨어를 설정할 수 있습니다.

IStartupFilter는 Action<IApplicationBuilder>를 받고 반환하는 Configure를 구현합니다. IApplicationBuilder는 앱의 요청 파이프라인을 구성하는 클래스를 정의합니다. 자세한 내용은 IApplicationBuilder로 미들웨어 파이프라인 만들기를 참조하세요.

각 IStartupFilter는 요청 파이프라인에서 하나 이상의 미들웨어를 추가할 수 있습니다. 필터는 서비스 컨테이너에 추가된 순서 대로 호출됩니다. 필터는 다음 필터에 컨트롤을 전달하기 전이나 후에 미들웨어를 추가할 수 있으므로 앱 파이프라인의 시작 또는 끝에 추가합니다.

다음 예제에서는 IStartupFilter를 사용하여 미들웨어를 등록하는 방법을 보여줍니다. RequestSetOptionsMiddleware 미들웨어는 쿼리 문자열 매개 변수에서 옵션 값을 설정합니다.

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

RequestSetOptionsMiddleware는 RequestSetOptionsStartupFilter 클래스에서 구성됩니다.

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

다음 IStartupFilter 에서 등록됩니다.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();

쿼리 문자열 매개 변수 option 가 제공되면 미들웨어는 ASP.NET Core 미들웨어가 응답을 렌더링하기 전에 값 할당을 처리합니다.

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

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

미들웨어 실행 순서는 IStartupFilter 등록 순서로 설정됩니다.

• 여러 IStartupFilter 구현은 동일한 개체와 상호 작용할 수 있습니다. 순서 지정이 중요한 경우 해당 미들웨어가 실행해야 하는 순서와 일치하도록 해당 IStartupFilter 서비스 등록의 순서를 지정합니다.

• 라이브러리는 IStartupFilter로 등록된 다른 앱 미들웨어 전이나 후에 실행하는 하나 이상의 IStartupFilter 구현으로 미들웨어를 추가할 수 있습니다. 라이브러리의 IStartupFilter에 의해 추가되는 미들웨어 전에 IStartupFilter 미들웨어를 호출하려면 다음을 수행합니다.

  • 라이브러리가 서비스 컨테이너에 추가되기 전에 서비스 등록의 위치를 지정합니다.
  • 나중에 호출하려면 라이브러리가 추가된 후에 서비스 등록의 위치를 지정합니다.

참고: 재정 Configure의할 때는 ASP.NET Core 앱을 확장할 수 없습니다. 자세한 내용은 이 GitHub 문제를 참조하세요.

시작 시 외부 어셈블리로부터 구성 추가

IHostingStartup 구현을 사용하면 앱 파일 외부의 외부 어셈블리에서 시작할 때 앱 Program.cs 에 향상된 기능을 추가할 수 있습니다. 자세한 내용은 ASP.NET Core에서 호스팅 시작 어셈블리 사용을 참조하세요.

시작, ConfigureServices 및 구성

최소 호스팅 모델에서 ConfigureServices 메서드 및 Configure 메서드를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

• 최소 호스팅 모델에서 시작 사용
• 이 문서의 ASP.NET Core 5.0 버전:
  • ConfigureServices 메서드
  • Configure 메서드