Codebeispiele, die zum neuen minimalen Hostingmodell in ASP.NET Core in .NET 6 migriert wurden

2025-05-28

Dieser Artikel enthält Beispiele für Code, der zu ASP.NET Core in .NET 6 migriert wurde. ASP.NET Core in .NET 6 verwendet ein neues minimales Hostingmodell. Weitere Informationen finden Sie unter "Neues Hostingmodell".

Middleware

Der folgende Code fügt die Static File Middleware zu einer .NET 5-App hinzu:

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseStaticFiles();
    }
}

Der folgende Code fügt die Static File Middleware zu einer ASP.NET Core in .NET 6-App hinzu:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseStaticFiles();

app.Run();

WebApplication.CreateBuilder Initialisiert eine neue Instanz der WebApplicationBuilder-Klasse mit vorkonfigurierten Standardwerten. Weitere Informationen finden Sie unter ASP.NET Core-Middleware.

Routenplanung

Mit dem folgenden Code wird einer .NET 5-App ein Endpunkt hinzugefügt:

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.UseRouting();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapGet("/", () => "Hello World");
        });
    }
}

In .NET 6 können Routen direkt dem WebApplication hinzugefügt werden, ohne einen expliziten Aufruf von UseEndpoints oder UseRouting. Der folgende Code fügt einen Endpunkt zu einer ASP.NET Core in .NET 6-App hinzu:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

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

app.Run();

Hinweis: Routen, die WebApplication direkt hinzugefügt werden, werden am Ende der Pipeline ausgeführt.

Ändern des Inhaltsstamms, des App-Namens und der Umgebung

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .UseContentRoot(Directory.GetCurrentDirectory())
        .UseEnvironment(Environments.Staging)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>()
                      .UseSetting(WebHostDefaults.ApplicationKey,
                                  typeof(Program).Assembly.FullName);
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    Args = args,
    ApplicationName = typeof(Program).Assembly.FullName,
    ContentRootPath = Directory.GetCurrentDirectory(),
    EnvironmentName = Environments.Staging,
    WebRootPath = "customwwwroot"
});

Console.WriteLine($"Application Name: {builder.Environment.ApplicationName}");
Console.WriteLine($"Environment Name: {builder.Environment.EnvironmentName}");
Console.WriteLine($"ContentRoot Path: {builder.Environment.ContentRootPath}");
Console.WriteLine($"WebRootPath: {builder.Environment.WebRootPath}");

var app = builder.Build();

Weitere Informationen finden Sie unter ASP.NET Core – Grundlagenübersicht.

Ändern von Inhaltsstamm, App-Name und Umgebung über Umgebungsvariablen oder Befehlszeile

Die folgende Tabelle zeigt die Umgebungsvariablen und Befehlszeilenargumente, die zum Ändern von Inhaltsstamm, Anwendungsname und Umgebung verwendet werden:

Merkmal	Umgebungsvariable	Befehlszeilenargument
Anwendungsname	ASPNETCORE_APPLICATIONNAME	--applicationName
Umgebungsname	ASPNETCORE_ENVIRONMENT	--Umwelt
Inhaltsstammverzeichnis	ASPNETCORE_CONTENTROOT	--contentRoot

Hinzufügen von Konfigurationsanbietern

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration(config =>
        {
            config.AddIniFile("appsettings.ini");
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddIniFile("appsettings.ini");

var app = builder.Build();

Ausführliche Informationen finden Sie unter Dateikonfigurationsanbieter in Konfiguration in ASP.NET Core.

Hinzufügen von Protokollierungsanbietern

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureLogging(logging =>
        {
            logging.AddJsonConsole();
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

// Configure JSON logging to the console.
builder.Logging.AddJsonConsole();

var app = builder.Build();

Weitere Informationen finden Sie unter Protokollierung in .NET Core und ASP.NET Core.

Dienste hinzufügen

ASP.NET Core in .NET 5

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // Add the memory cache services
        services.AddMemoryCache();

        // Add a custom scoped service
        services.AddScoped<ITodoRepository, TodoRepository>();
    }
}

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

// Add the memory cache services.
builder.Services.AddMemoryCache();

// Add a custom scoped service.
builder.Services.AddScoped<ITodoRepository, TodoRepository>();
var app = builder.Build();

Weitere Informationen finden Sie unter Abhängigkeitsinjektion in ASP.NET Core.

Anpassen von IHostBuilder oder IWebHostBuilder

Anpassen von IHostBuilder

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureHostOptions(o => o.ShutdownTimeout = TimeSpan.FromSeconds(30));
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

// Wait 30 seconds for graceful shutdown.
builder.Host.ConfigureHostOptions(o => o.ShutdownTimeout = TimeSpan.FromSeconds(30));

var app = builder.Build();

Anpassen von IWebHostBuilder

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            // Change the HTTP server implementation to be HTTP.sys based.
            webBuilder.UseHttpSys()
                      .UseStartup<Startup>();
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

// Change the HTTP server implementation to be HTTP.sys based.
// Windows only.
builder.WebHost.UseHttpSys();

var app = builder.Build();

Ändern des Webstamms

Standardmäßig ist der Webstamm relativ zum Inhaltsstamm im Ordner wwwroot angegeben. Im Webstamm sucht die Middleware für statische Dateien nach statischen Dateien. Das Web-Root-Verzeichnis kann geändert werden, indem die WebRootPath-Eigenschaft auf WebApplicationOptions festgelegt wird:

ASP.NET Core in .NET 5

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureWebHostDefaults(webBuilder =>
        {
            // Look for static files in webroot.
            webBuilder.UseWebRoot("webroot")
                      .UseStartup<Startup>();
        });

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    Args = args,
    // Look for static files in webroot
    WebRootPath = "webroot"
});

var app = builder.Build();

Container für benutzerdefinierte Abhängigkeitsinjektion

Die folgenden .NET 5- und .NET 6-Beispiele verwenden Autofac

ASP.NET Core in .NET 5

Programmklasse

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .UseServiceProviderFactory(new AutofacServiceProviderFactory())
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

Start-up

public class Startup
{
    public void ConfigureContainer(ContainerBuilder containerBuilder)
    {
    }
}

ASP.NET Core in .NET 6

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseServiceProviderFactory(new AutofacServiceProviderFactory());

// Register services directly with Autofac here. Don't
// call builder.Populate(), that happens in AutofacServiceProviderFactory.
builder.Host.ConfigureContainer<ContainerBuilder>(builder => builder.RegisterModule(new MyApplicationModule()));

var app = builder.Build();

Zugriff auf zusätzliche Dienste

Startup.Configure kann jeden hinzugefügten Dienst einfügen, der über die IServiceCollection.

ASP.NET Core in .NET 5

public class Startup
{
    // This method gets called by the runtime. Use this method to add services
    // to the container.
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSingleton<IService, Service>();
    }

    // Anything added to the service collection can be injected into Configure.
    public void Configure(IApplicationBuilder app,
                          IWebHostEnvironment env,
                          IHostApplicationLifetime lifetime,
                          IService service,
                          ILogger<Startup> logger)
    {
        lifetime.ApplicationStarted.Register(() =>
            logger.LogInformation(
                "The application {Name} started in the injected {Service}",
                env.ApplicationName, service));
    }
}

ASP.NET Core in .NET 6

In ASP.NET Core in .NET 6:

Es gibt einige allgemeine Dienste, die als Eigenschaften auf oberster Ebene von WebApplication verfügbar sind.
Zusätzliche Dienste müssen über IServiceProviderWebApplication.Services manuell aufgelöst werden.

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSingleton<IService, Service>();

var app = builder.Build();

IService service = app.Services.GetRequiredService<IService>();
ILogger logger = app.Logger;
IHostApplicationLifetime lifetime = app.Lifetime;
IWebHostEnvironment env = app.Environment;

lifetime.ApplicationStarted.Register(() =>
    logger.LogInformation(
        $"The application {env.ApplicationName} started" +
        $" with injected {service}"));

Testen mit WebApplicationFactory oder TestServer

ASP.NET Core in .NET 5

In den folgenden Beispielen nutzt das Testprojekt TestServer und WebApplicationFactory<TEntryPoint>. Diese Pakete werden als separate Pakete geliefert, die expliziten Verweis erfordern:

WebApplicationFactory

<ItemGroup>
  <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="{Version}" />
</ItemGroup>

TestServer

<ItemGroup>
  <PackageReference Include="Microsoft.AspNetCore.TestHost" Version="{Version}" />
</ItemGroup>

ASP.NET Core in .NET 5 Code

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSingleton<IHelloService, HelloService>();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IHelloService helloService)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapGet("/", async context =>
            {
                await context.Response.WriteAsync(helloService.HelloMessage);
            });
        });
    }
}

Mit TestServer

[Fact]
public async Task HelloWorld()
{
    using var host = Host.CreateDefaultBuilder()
        .ConfigureWebHostDefaults(builder =>
        {
            // Use the test server and point to the application's startup
            builder.UseTestServer()
                    .UseStartup<WebApplication1.Startup>();
        })
        .ConfigureServices(services =>
        {
            // Replace the service
            services.AddSingleton<IHelloService, MockHelloService>();
        })
        .Build();

    await host.StartAsync();

    var client = host.GetTestClient();

    var response = await client.GetStringAsync("/");

    Assert.Equal("Test Hello", response);
}

class MockHelloService : IHelloService
{
    public string HelloMessage => "Test Hello";
}

Mit WebApplicationFactory

[Fact]
public async Task HelloWorld()
{
    var application = new WebApplicationFactory<Program>()
        .WithWebHostBuilder(builder =>
        {
            builder.ConfigureServices(services =>
            {
                services.AddSingleton<IHelloService, MockHelloService>();
            });
        });

    var client = application.CreateClient();

    var response = await client.GetStringAsync("/");

    Assert.Equal("Test Hello", response);
}

class MockHelloService : IHelloService
{
    public string HelloMessage => "Test Hello";
}

ASP.NET Core in .NET 6


var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSingleton<IHelloService, HelloService>();

var app = builder.Build();

var helloService = app.Services.GetRequiredService<IHelloService>();

app.MapGet("/", async context =>
{
    await context.Response.WriteAsync(helloService.HelloMessage);
});

app.Run();

Projektdatei (.csproj)

Die Projektdatei kann eine der folgenden Elemente enthalten:

<ItemGroup>
    <InternalsVisibleTo Include="MyTestProject" />
</ItemGroup>

Oder

[assembly: InternalsVisibleTo("MyTestProject")]

Eine alternative Lösung besteht darin, die Program Klasse öffentlich zu machen. Program kann mit Anweisungen auf oberster Ebene veröffentlicht werden, indem eine public partial Program Klasse im Projekt oder in Program.cs definiert wird:

var builder = WebApplication.CreateBuilder(args);

// ... Configure services, routes, etc.

app.Run();

public partial class Program { }

[Fact]
public async Task HelloWorld()
{
    var application = new WebApplicationFactory<Program>()
        .WithWebHostBuilder(builder =>
        {
            builder.ConfigureServices(services =>
            {
                services.AddSingleton<IHelloService, MockHelloService>();
            });
        });

    var client = application.CreateClient();

    var response = await client.GetStringAsync("/");

    Assert.Equal("Test Hello", response);
}

class MockHelloService : IHelloService
{
    public string HelloMessage => "Test Hello";
}

Die .NET 5-Version und die .NET 6-Version mit dem WebApplicationFactory sind absichtlich identisch gestaltet.

Teilen über

Codebeispiele, die zum neuen minimalen Hostingmodell in ASP.NET Core in .NET 6 migriert wurden

Middleware

Routenplanung

Ändern des Inhaltsstamms, des App-Namens und der Umgebung

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Ändern von Inhaltsstamm, App-Name und Umgebung über Umgebungsvariablen oder Befehlszeile

Hinzufügen von Konfigurationsanbietern

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Hinzufügen von Protokollierungsanbietern

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Dienste hinzufügen

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Anpassen von IHostBuilder oder IWebHostBuilder

Anpassen von IHostBuilder

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Anpassen von IWebHostBuilder

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Ändern des Webstamms

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Container für benutzerdefinierte Abhängigkeitsinjektion

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Zugriff auf zusätzliche Dienste

ASP.NET Core in .NET 5

ASP.NET Core in .NET 6

Testen mit WebApplicationFactory oder TestServer

ASP.NET Core in .NET 5

WebApplicationFactory

TestServer

ASP.NET Core in .NET 5 Code

Mit TestServer

Mit WebApplicationFactory

ASP.NET Core in .NET 6

Projektdatei (.csproj)

Feedback

Zusätzliche Ressourcen