All 15 Generic Host questions
More in Generic Host
What is the Generic Host in .NET, and what problem does it standardize across different application types? What is the difference between Host.CreateApplicationBuilder and the older Host.CreateDefaultBuilder? How does the Generic Host integrate configuration, logging, and dependency injection into a single unified builder? What is IHostEnvironment, and how do you use it to conditionally configure services based on the current environment? How do you register configuration and services differently for a Worker Service running as a Windows Service or systemd daemon? What is the role of IHostLifetime, and how does it differ across console applications, Windows Services, and containers? How do you access the built IHost's service provider after Build() to resolve services outside the normal request/injection flow, such as in Program.cs itself? How do you configure the Generic Host to read configuration from a custom file format or remote source before the rest of the application starts? How does the Generic Host manage the application's startup and shutdown lifecycle, including handling OS signals like SIGTERM? How would you build a console application that supports both interactive command execution and long-running hosted service behavior using the Generic Host?
Advertisement
.NET › Generic Host

What does calling host.Run() versus host.RunAsync() do, and when would you use each?

Beginner

Answer

host.Run() is a blocking call that starts the host and blocks the calling thread until the application shuts down (via a shutdown signal or programmatic stop), suitable for a Program.cs's final statement in most applications. host.RunAsync() returns a Task instead, letting you await it while still doing other async work concurrently, or combine it with other awaited tasks -- useful in more complex startup scenarios where you need additional coordination logic around the host's lifetime.
// Simple, most common case
var host = builder.Build();
host.Run();  // blocks here until shutdown

// More complex: awaiting alongside other async startup logic
await host.StartAsync();
await DoAdditionalSetupAsync();
await host.WaitForShutdownAsync();
Real-world example A typical Worker Service Program.cs simply calls host.Run() as its final line, while a more complex hybrid application uses host.RunAsync() combined with additional coordination logic for a custom startup sequence.

Common follow-ups: What does host.WaitForShutdownAsync() do differently from Run()?;How do you programmatically trigger a shutdown from within application code?

Generic Host;Background Services
All 15 Generic Host questions