From 1207206c1071e391fe4c6ad4cd5c441e021c986a Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Thu, 12 Dec 2024 20:47:17 -0800 Subject: [PATCH] mention blazor and misc cleanup --- aspnetcore/fundamentals/startup.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/aspnetcore/fundamentals/startup.md b/aspnetcore/fundamentals/startup.md index a41dbb1540dd..363d8618e32a 100644 --- a/aspnetcore/fundamentals/startup.md +++ b/aspnetcore/fundamentals/startup.md @@ -5,7 +5,7 @@ description: Learn how the Startup class in ASP.NET Core configures services and monikerRange: '>= aspnetcore-3.1' ms.author: wpickett ms.custom: mvc -ms.date: 5/5/2023 +ms.date: 12/12/2024 uid: fundamentals/startup --- # App startup in ASP.NET Core @@ -20,18 +20,17 @@ ASP.NET Core apps created with the web templates contain the application startup For Blazor startup guidance, which adds to or supersedes the guidance in this article, see . -The following app startup code supports: +The following app startup code supports several app types: +* [Blazor Web Apps](xref:blazor/index) * [Razor Pages](xref:tutorials/razor-pages/razor-pages-start) * [MVC controllers with views](xref:tutorials/first-mvc-app/start-mvc) * [Web API with controllers](xref:tutorials/first-web-api) * [Minimal APIs](xref:tutorials/min-web-api) -[!code-csharp[](~/fundamentals/startup/6.0_samples/WebAll/Program.cs?name=snippet)] +[!code-csharp[](~/fundamentals/startup/9.0_samples/WebAll/Program.cs?name=snippet)] -Apps using [EventSource](/dotnet/api/system.diagnostics.tracing.eventsource) can measure the startup time to understand and optimize startup performance. The [`ServerReady`](https://source.dot.net/#Microsoft.AspNetCore.Hosting/Internal/HostingEventSource.cs,76) event in represents the point where the server is ready to respond to requests. - -For more information on application startup, see . +Apps that use can measure the startup time to understand and optimize startup performance. The [`ServerReady`](https://source.dot.net/#Microsoft.AspNetCore.Hosting/Internal/HostingEventSource.cs,76) event in represents the point where the server is ready to respond to requests. @@ -42,9 +41,9 @@ Use : * To configure middleware at the beginning or end of an app's middleware pipeline without an explicit call to `Use{Middleware}`. Use `IStartupFilter` to add defaults to the beginning of the pipeline without explicitly registering the default middleware. `IStartupFilter` allows a different component to call `Use{Middleware}` on behalf of the app author. * To create a pipeline of `Configure` methods. [IStartupFilter.Configure](xref:Microsoft.AspNetCore.Hosting.IStartupFilter.Configure%2A) can set a middleware to run before or after middleware added by libraries. -`IStartupFilter` implements , which receives and returns an `Action`. An defines a class to configure an app's request pipeline. For more information, see [Create a middleware pipeline with IApplicationBuilder](xref:fundamentals/middleware/index#create-a-middleware-pipeline-with-iapplicationbuilder). +An `IStartupFilter` implementation implements , which receives and returns an `Action`. An defines a class to configure an app's request pipeline. For more information, see [Create a middleware pipeline with IApplicationBuilder](xref:fundamentals/middleware/index#create-a-middleware-pipeline-with-iapplicationbuilder). -Each `IStartupFilter` can add one or more middlewares in the request pipeline. The filters are invoked in the order they were added to the service container. Filters may add middleware before or after passing control to the next filter, thus they append to the beginning or end of the app pipeline. +Each `IStartupFilter` implementation can add one or more middlewares in the request pipeline. The filters are invoked in the order they were added to the service container. Filters can add middleware before or after passing control to the next filter, thus they append to the beginning or end of the app pipeline. The following example demonstrates how to register a middleware with `IStartupFilter`. The `RequestSetOptionsMiddleware` middleware sets an options value from a query string parameter: @@ -52,9 +51,9 @@ The following example demonstrates how to register a middleware with `IStartupFi The `RequestSetOptionsMiddleware` is configured in the `RequestSetOptionsStartupFilter` class: -[!code-csharp[](~/fundamentals/startup/7/WebStartup/Middleware/RequestSetOptionsStartupFilter.cs?name=snippet1?name=snippet1&highlight=7)] +[!code-csharp[](~/fundamentals/startup/7/WebStartup/Middleware/RequestSetOptionsStartupFilter.cs?name=snippet1&highlight=7)] -The `IStartupFilter` is registered in `Program.cs`: +The `IStartupFilter` implementation is registered in `Program.cs`: [!code-csharp[](~/fundamentals/startup/7/WebStartup/Program.cs?highlight=6-7)] @@ -64,13 +63,13 @@ When a query string parameter for `option` is provided, the middleware processes Middleware execution order is set by the order of `IStartupFilter` registrations: -* Multiple `IStartupFilter` implementations may interact with the same objects. If ordering is important, order their `IStartupFilter` service registrations to match the order that their middlewares should run. -* Libraries may add middleware with one or more `IStartupFilter` implementations that run before or after other app middleware registered with `IStartupFilter`. To invoke an `IStartupFilter` middleware before a middleware added by a library's `IStartupFilter`: +* Multiple `IStartupFilter` implementations might interact with the same objects. If ordering is important, order their `IStartupFilter` service registrations to match the order that their middlewares should run. +* Libraries can add middleware with one or more `IStartupFilter` implementations that run before or after other app middleware registered with `IStartupFilter`. To invoke an `IStartupFilter` middleware before a middleware added by a library's `IStartupFilter`: * Position the service registration before the library is added to the service container. * To invoke afterward, position the service registration after the library is added. -Note: You can't extend the ASP.NET Core app when you override `Configure`. For more informaton, see [this GitHub issue](https://github.com/dotnet/aspnetcore/issues/45372). +You can't extend the ASP.NET Core app when you override `Configure`. For more information, see [this GitHub issue](https://github.com/dotnet/aspnetcore/issues/45372). ## Add configuration at startup from an external assembly