ASP.NET Core'da uygulama başlatma

Gönderen Rick Anderson

Web şablonlarıyla oluşturulan ASP.NET Core uygulamaları, Program.cs dosyasındaki uygulama başlangıç kodunu içerir.

Blazor Bu makaledeki yönergeleri ekleyen veya yerine geçen başlangıç kılavuzu için bkz. ASP.NET Core Blazor başlatma.

Aşağıdaki uygulama başlangıç kodu aşağıdakileri destekler:

• Razor Sayfaları
• Görünümlere sahip MVC denetleyicileri
• Denetleyicilerle web API'si
• Minimum API'ler

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 kullanan uygulamalar, başlangıç performansını anlamak ve iyileştirmek için başlangıç süresini ölçebilir. ServerReady içindeki Microsoft.AspNetCore.Hosting olayı, sunucunun isteklere yanıt vermeye hazır olduğu noktayı temsil eder.

Uygulama başlatma hakkında daha fazla bilgi için bkz . ASP.NET Temel bilgilere genel bakış.

Başlangıç filtreleriyle Başlangıç'ı genişletme

IStartupFilter kullanın:

• Bir uygulamanın ara yazılım işlem hattının başında veya sonunda ara yazılımı açık bir çağrı olmadan yapılandırmak için Use{Middleware}. Varsayılan ara yazılımı açıkça kaydetmeden işlem hattının başına varsayılan değerleri eklemek için kullanın IStartupFilter . IStartupFilter farklı bir bileşenin uygulama yazarı adına arama Use{Middleware} yapmasına izin verir.
• Yöntemlerden oluşan Configure bir işlem hattı oluşturmak için. IStartupFilter.Configure , kitaplıklar tarafından eklenen ara yazılımdan önce veya sonra çalışacak bir ara yazılım ayarlayabilir.

IStartupFilterConfigure, alır ve döndürür Action<IApplicationBuilder>uygular. , IApplicationBuilder bir uygulamanın istek işlem hattını yapılandırmak için bir sınıf tanımlar. Daha fazla bilgi için bkz . IApplicationBuilder ile ara yazılım işlem hattı oluşturma.

Her IStartupFilter biri istek işlem hattına bir veya daha fazla ara yazılım ekleyebilir. Filtreler, hizmet kapsayıcısına eklendikleri sırayla çağrılır. Filtreler, denetimi bir sonraki filtreye geçirmeden önce veya sonra ara yazılım ekleyebilir, bu nedenle uygulama işlem hattının başına veya sonuna eklenir.

Aşağıdaki örnekte ile IStartupFilterara yazılım kaydetme işlemi gösterilmektedir. Ara yazılım, RequestSetOptionsMiddleware sorgu dizesi parametresinden bir seçenek değeri ayarlar:

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 sınıfında yapılandırılırRequestSetOptionsStartupFilter:

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

IStartupFilter içinde kayıtlıdırProgram.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();

için option bir sorgu dizesi parametresi sağlandığında ara yazılım, ASP.NET Core ara yazılımı yanıtı işlemeden önce değer atamasını işler:

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

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

Ara yazılım yürütme sırası, kayıtların IStartupFilter sırasına göre ayarlanır:

• Birden çok IStartupFilter uygulama aynı nesnelerle etkileşime geçebilir. Sıralama önemliyse, hizmet kayıtlarını ara yazılımlarının çalışması gereken siparişle eşleşecek şekilde sipariş IStartupFilter edin.

• Kitaplıklar, ile kaydedilen diğer uygulama ara yazılımından önce veya sonra çalışan bir veya daha fazla IStartupFilter uygulamayla IStartupFilterara yazılım ekleyebilir. Kitaplığın IStartupFilter tarafından eklenen ara yazılımdan önce ara yazılımı çağırmak IStartupFilteriçin:

  • Kitaplık hizmet kapsayıcısına eklenmeden önce hizmet kaydını konumlandırın.
  • Daha sonra çağırmak için, kitaplık eklendikten sonra hizmet kaydını konumlandırın.

Not: ASP.NET Core uygulamasını geçersiz kıldığınızda Configuregenişletemezsiniz. Daha fazla bilgi için bu GitHub sorununa bakın.

Dış derlemeden başlangıçta yapılandırma ekleme

Uygulama IHostingStartup , uygulamanın dosyasının dışındaki bir dış derlemeden başlangıçta uygulamaya Program.cs iyileştirmeler eklemeye olanak tanır. Daha fazla bilgi için, bkz. ASP.NET Core'da barındırma başlangıç derlemelerini kullanma.

Başlatma, YapılandırmaHizmetleri ve Yapılandırma

ve Configure yöntemlerini en düşük barındırma modeliyle kullanma ConfigureServices hakkında bilgi için bkz:

• Minimum barındırma modeliyle Başlangıç'ı kullanma
• Bu makalenin ASP.NET Core 5.0 sürümü:
  • ConfigureServices yöntemi
  • Configure yöntemi