ASP.NET Core'da uygulama başlatma

Tarafından Rick Anderson

Web şablonlarıyla oluşturulan ASP.NET Core uygulamalar, Program.cs dosyasındaki uygulama başlatma 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 çeşitli uygulama türlerini destekler:

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

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

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

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

IStartupFilter kullanın:

• Bir uygulamanın ara yazılım akışının başında veya sonunda, açık bir çağrı yapmadan ara yazılımı 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 geliştiricisi adına Use{Middleware} çağrı yapmasına müsaade eder.

• 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.

Bir IStartupFilter uygulama, bir Configure Action<IApplicationBuilder> alan ve döndüren bir yöntem sağlar. , 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 uygulaması, 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 örnek, IStartupFilter ile bir middleware kaydetme işlemini göstermektedir. 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, RequestSetOptionsStartupFilter sınıfında yapılandırılır:

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

Uygulama IStartupFilterProgram.cs dosyasına kaydedilir:

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 uygulaması aynı nesnelerle etkileşimde olabilir. Sıra önemliyse, hizmet kayıtlarını ara yazılımlarının çalışması gereken sıraya uygun olacak şekilde sıraya IStartupFilter koyun.

• Kitaplıklar, bir veya daha fazla IStartupFilter uygulaması içeren ara yazılımlarını, IStartupFilterile kaydedilen diğer uygulama ara yazılımlarından önce veya sonra çalışacak şekilde ekleyebilir. Bir kitaplık tarafından eklenen bir ara yazılımdan önce bir IStartupFilter ara yazılımı çağırmak için:

  • Hizmet kapsayıcısına kütüphane eklenmeden önce hizmet kaydını konumlandırın.

  • Hizmeti daha sonra çağırmak için, kitaplık eklendikten sonra hizmet kaydını konumlandırın.

Configuregeçersiz kıldığınızda ASP.NET Core uygulamasını genişletemezsiniz. Daha fazla bilgi için bkz. GitHub /dotnet/aspnetcore/issues #45372.

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

Uygulama, IHostingStartup uygulama Program.cs dosyasının dışındaki bir dış derlemeden başlangıçta uygulamaya iyileştirmeler eklenmesine 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

Minimal barındırma modeliyle birlikte ConfigureServices ve Configure yöntemlerini kullanma hakkında bilgi için bkz:

• Minimum barındırma modeliyle Başlangıç'ı kullanma
• Başlangıç Sınıfı (bu makalenin .NET 5 sürümü):
  • ConfigureServices yöntemi
  • Configure yöntemi

İlgili içerik

• ASP.NET Temel bilgilerine genel bakış
• ASP.NET Core'da yapılandırma