From 247e6f1526e593107b548486815767538eb4b563 Mon Sep 17 00:00:00 2001 From: Luke Latham <1622880+guardrex@users.noreply.github.com> Date: Wed, 18 Sep 2024 05:58:22 -0400 Subject: [PATCH] Blazor cross-links (#33577) --- aspnetcore/fundamentals/app-state.md | 2 ++ .../fundamentals/configuration/index.md | 2 ++ .../fundamentals/dependency-injection.md | 2 ++ aspnetcore/fundamentals/environments.md | 2 ++ aspnetcore/fundamentals/error-handling.md | 2 ++ aspnetcore/fundamentals/index.md | 2 ++ aspnetcore/fundamentals/localization.md | 2 ++ aspnetcore/fundamentals/logging/index.md | 4 +++- aspnetcore/fundamentals/native-aot.md | 2 ++ aspnetcore/fundamentals/routing.md | 1 + aspnetcore/fundamentals/startup.md | 2 ++ aspnetcore/fundamentals/static-files.md | 4 ++++ aspnetcore/getting-started/index.md | 2 ++ aspnetcore/host-and-deploy/index.md | 2 ++ aspnetcore/performance/overview.md | 20 ++++++++++++++++++- .../security/authentication/accconfirm.md | 2 +- aspnetcore/signalr/configuration.md | 4 ++++ aspnetcore/signalr/introduction.md | 3 ++- aspnetcore/test/debug-aspnetcore-source.md | 1 + aspnetcore/toc.yml | 2 ++ 20 files changed, 59 insertions(+), 4 deletions(-) diff --git a/aspnetcore/fundamentals/app-state.md b/aspnetcore/fundamentals/app-state.md index bf0bb5fa948e..ff8876142017 100644 --- a/aspnetcore/fundamentals/app-state.md +++ b/aspnetcore/fundamentals/app-state.md @@ -15,6 +15,8 @@ By [Rick Anderson](https://twitter.com/RickAndMSFT), [Kirk Larkin](https://twitt HTTP is a stateless protocol. By default, HTTP requests are independent messages that don't retain user values. This article describes several approaches to preserve user data between requests. +For Blazor state management guidance, which adds to or supersedes the guidance in this article, see . + ## State management State can be stored using several approaches. Each approach is described later in this article. diff --git a/aspnetcore/fundamentals/configuration/index.md b/aspnetcore/fundamentals/configuration/index.md index e6f56f3e4b2e..785f46db77a5 100644 --- a/aspnetcore/fundamentals/configuration/index.md +++ b/aspnetcore/fundamentals/configuration/index.md @@ -29,6 +29,8 @@ Application configuration in ASP.NET Core is performed using one or more [config This article provides information on configuration in ASP.NET Core. For information on using configuration in console apps, see [.NET Configuration](/dotnet/core/extensions/configuration). +For Blazor configuration guidance, which adds to or supersedes the guidance in this node, see . + ## Application and Host Configuration ASP.NET Core apps configure and launch a *host*. The host is responsible for app startup and lifetime management. The ASP.NET Core templates create a which contains the host. While some configuration can be done in both the host and the application configuration providers, generally, only configuration that is necessary for the host should be done in host configuration. diff --git a/aspnetcore/fundamentals/dependency-injection.md b/aspnetcore/fundamentals/dependency-injection.md index f1939c4a89e0..7b6d327e2ce9 100644 --- a/aspnetcore/fundamentals/dependency-injection.md +++ b/aspnetcore/fundamentals/dependency-injection.md @@ -25,6 +25,8 @@ For more information on dependency injection of options, see . + [View or download sample code](https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/fundamentals/dependency-injection/samples) ([how to download](xref:index#how-to-download-a-sample)) ## Overview of dependency injection diff --git a/aspnetcore/fundamentals/environments.md b/aspnetcore/fundamentals/environments.md index f194ee819457..bf59f2606d78 100644 --- a/aspnetcore/fundamentals/environments.md +++ b/aspnetcore/fundamentals/environments.md @@ -18,6 +18,8 @@ By [Rick Anderson](https://twitter.com/RickAndMSFT) and [Kirk Larkin](https://tw ASP.NET Core configures app behavior based on the runtime environment using an environment variable. +For Blazor environments guidance, which adds to or supersedes the guidance in this article, see . + ## Environments :::moniker-end diff --git a/aspnetcore/fundamentals/error-handling.md b/aspnetcore/fundamentals/error-handling.md index c5bb829e1e4b..06597bac65a7 100644 --- a/aspnetcore/fundamentals/error-handling.md +++ b/aspnetcore/fundamentals/error-handling.md @@ -18,6 +18,8 @@ By [Tom Dykstra](https://github.com/tdykstra/) This article covers common approaches to handling errors in ASP.NET Core web apps. See also and . +For Blazor error handling guidance, which adds to or supersedes the guidance in this article, see . + ## Developer exception page [!INCLUDE [](../includes/developer-exception-page.md)] diff --git a/aspnetcore/fundamentals/index.md b/aspnetcore/fundamentals/index.md index 435ee3a685c2..515d419359f5 100644 --- a/aspnetcore/fundamentals/index.md +++ b/aspnetcore/fundamentals/index.md @@ -16,6 +16,8 @@ uid: fundamentals/index This article provides an overview of the fundamentals for building ASP.NET Core apps, including dependency injection (DI), configuration, middleware, and more. +For Blazor fundamentals guidance, which adds to or supersedes the guidance in this node, see . + ## Program.cs ASP.NET Core apps created with the web templates contain the application startup code in the `Program.cs` file. The `Program.cs` file is where: diff --git a/aspnetcore/fundamentals/localization.md b/aspnetcore/fundamentals/localization.md index 5c9f73c159ec..8a8699816e41 100644 --- a/aspnetcore/fundamentals/localization.md +++ b/aspnetcore/fundamentals/localization.md @@ -17,6 +17,8 @@ By [Rick Anderson](https://twitter.com/RickAndMSFT), [Damien Bowden](https://twi A multilingual website allows a website to reach a wider audience. ASP.NET Core provides services and middleware for localizing into different languages and cultures. +For Blazor localization guidance, which adds to or supersedes the guidance in this article, see . + ## Terms * Globalization (G11N): The process of making an app support different languages and regions. The abbreviation comes from the first and last letters and the number of letters between them. diff --git a/aspnetcore/fundamentals/logging/index.md b/aspnetcore/fundamentals/logging/index.md index 55f57ade0e0d..8a995c25b4d7 100644 --- a/aspnetcore/fundamentals/logging/index.md +++ b/aspnetcore/fundamentals/logging/index.md @@ -17,7 +17,9 @@ uid: fundamentals/logging/index By [Kirk Larkin](https://twitter.com/serpent5), [Juergen Gutsch](https://github.com/JuergenGutsch), and [Rick Anderson](https://twitter.com/RickAndMSFT) -This article describes logging in .NET as it applies to ASP.NET Core apps. For detailed information on logging in .NET, see [Logging in .NET](/dotnet/core/extensions/logging). For more information on logging in Blazor apps, see . +This article describes logging in .NET as it applies to ASP.NET Core apps. For detailed information on logging in .NET, see [Logging in .NET](/dotnet/core/extensions/logging). + +For Blazor logging guidance, which adds to or supersedes the guidance in this node, see . diff --git a/aspnetcore/fundamentals/native-aot.md b/aspnetcore/fundamentals/native-aot.md index 9d7cc7b83e19..a069905a6230 100644 --- a/aspnetcore/fundamentals/native-aot.md +++ b/aspnetcore/fundamentals/native-aot.md @@ -23,6 +23,8 @@ By [Mitch Denny](https://github.com/mitchdenny) ASP.NET Core 8.0 introduces support for [.NET native ahead-of-time (AOT)](/dotnet/core/deploying/native-aot/). +For Blazor WebAssembly Native AOT guidance, which adds to or supersedes the guidance in this article, see . + ## Why use Native AOT with ASP.NET Core Publishing and deploying a Native AOT app provides the following benefits: diff --git a/aspnetcore/fundamentals/routing.md b/aspnetcore/fundamentals/routing.md index 7b99e156be3a..c8bdc9f5afa0 100644 --- a/aspnetcore/fundamentals/routing.md +++ b/aspnetcore/fundamentals/routing.md @@ -33,6 +33,7 @@ This article covers low-level details of ASP.NET Core routing. For information o * For controllers, see . * For Razor Pages conventions, see . +* For Blazor routing guidance, which adds to or supersedes the guidance in this article, see . ## Routing basics diff --git a/aspnetcore/fundamentals/startup.md b/aspnetcore/fundamentals/startup.md index 4da24434e3a6..a41dbb1540dd 100644 --- a/aspnetcore/fundamentals/startup.md +++ b/aspnetcore/fundamentals/startup.md @@ -18,6 +18,8 @@ By [Rick Anderson](https://twitter.com/RickAndMSFT) ASP.NET Core apps created with the web templates contain the application startup code in the `Program.cs` file. +For Blazor startup guidance, which adds to or supersedes the guidance in this article, see . + The following app startup code supports: * [Razor Pages](xref:tutorials/razor-pages/razor-pages-start) diff --git a/aspnetcore/fundamentals/static-files.md b/aspnetcore/fundamentals/static-files.md index cd4bde90a6a3..ae30e2341fd6 100644 --- a/aspnetcore/fundamentals/static-files.md +++ b/aspnetcore/fundamentals/static-files.md @@ -18,6 +18,8 @@ By [Rick Anderson](https://twitter.com/RickAndMSFT) Static files, such as HTML, CSS, images, and JavaScript, are assets an ASP.NET Core app serves directly to clients by default. +For Blazor static files guidance, which adds to or supersedes the guidance in this article, see . + ## Serve static files Static files are stored within the project's [web root](xref:fundamentals/index#web-root) directory. The default directory is `{content root}/wwwroot`, but it can be changed with the method. For more information, see [Content root](xref:fundamentals/index#content-root) and [Web root](xref:fundamentals/index#web-root). @@ -333,6 +335,8 @@ The following code updates `IWebHostEnvironment.WebRootPath` to a non developmen * [View or download sample code](https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/fundamentals/static-files/samples) ([how to download](xref:index#how-to-download-a-sample)) * [Middleware](xref:fundamentals/middleware/index) * [Introduction to ASP.NET Core](xref:index) +* +* :::moniker-end diff --git a/aspnetcore/getting-started/index.md b/aspnetcore/getting-started/index.md index 12432c0f634e..e0e00344cd94 100644 --- a/aspnetcore/getting-started/index.md +++ b/aspnetcore/getting-started/index.md @@ -14,6 +14,8 @@ uid: getting-started This tutorial shows how to create and run an ASP.NET Core web app using the .NET CLI. +For Blazor tutorials, see . + You'll learn how to: > [!div class="checklist"] diff --git a/aspnetcore/host-and-deploy/index.md b/aspnetcore/host-and-deploy/index.md index 3117806405d5..bf9e221c2805 100644 --- a/aspnetcore/host-and-deploy/index.md +++ b/aspnetcore/host-and-deploy/index.md @@ -20,6 +20,8 @@ In general, to deploy an ASP.NET Core app to a hosting environment: * Set up a process manager that starts the app when requests arrive and restarts the app after it crashes or the server reboots. * For configuration of a reverse proxy, set up a reverse proxy to forward requests to the app. +For Blazor host and deploy guidance, which adds to or supersedes the guidance in this node, see . + ## Publish to a folder The [dotnet publish](/dotnet/core/tools/dotnet-publish) command compiles app code and copies the files required to run the app into a *publish* folder. When deploying from Visual Studio, the `dotnet publish` step occurs automatically before the files are copied to the deployment destination. diff --git a/aspnetcore/performance/overview.md b/aspnetcore/performance/overview.md index 0408ae2582f7..4578a97bd206 100644 --- a/aspnetcore/performance/overview.md +++ b/aspnetcore/performance/overview.md @@ -11,6 +11,9 @@ uid: performance/overview The following articles provide information about how to optimize the performance of ASP.NET Core apps: +:::moniker range=">= aspnetcore-8.0" + +* * * * @@ -20,7 +23,22 @@ The following articles provide information about how to optimize the performance * * * -:::moniker range=">= aspnetcore-8.0" * * [Short-circuit middleware after routing](xref:fundamentals/routing#short-circuit-middleware-after-routing) + +:::moniker-end + +:::moniker range="< aspnetcore-8.0" + +* +* +* +* +* +* +* +* +* +* + :::moniker-end diff --git a/aspnetcore/security/authentication/accconfirm.md b/aspnetcore/security/authentication/accconfirm.md index 59473cb69b10..c51718eeed7f 100644 --- a/aspnetcore/security/authentication/accconfirm.md +++ b/aspnetcore/security/authentication/accconfirm.md @@ -19,7 +19,7 @@ This tutorial shows how to build an ASP.NET Core app with email confirmation and :::moniker range=">= aspnetcore-8.0" -For Blazor guidance, see . +For Blazor guidance, which adds to or supersedes the guidance in this article, see . :::moniker-end diff --git a/aspnetcore/signalr/configuration.md b/aspnetcore/signalr/configuration.md index 619d6e7bca84..7ce850ea32ad 100644 --- a/aspnetcore/signalr/configuration.md +++ b/aspnetcore/signalr/configuration.md @@ -11,6 +11,10 @@ uid: signalr/configuration # ASP.NET Core SignalR configuration +This article covers ASP.NET Core SignalR configuration. + +For Blazor SignalR guidance, which adds to or supersedes the guidance in this article, see . + :::moniker range=">= aspnetcore-8.0" ## JSON/MessagePack serialization options diff --git a/aspnetcore/signalr/introduction.md b/aspnetcore/signalr/introduction.md index cfcd4a829a46..0f7cb6a822cc 100644 --- a/aspnetcore/signalr/introduction.md +++ b/aspnetcore/signalr/introduction.md @@ -60,4 +60,5 @@ Hubs call client-side code by sending messages that contain the name and paramet * [Supported Platforms](xref:signalr/supported-platforms) * [Hubs](xref:signalr/hubs) * [JavaScript client](xref:signalr/javascript-client) -* [Browsers that don't support ECMAScript 6 (ES6)](xref:signalr/supported-platforms#es6) \ No newline at end of file +* [Browsers that don't support ECMAScript 6 (ES6)](xref:signalr/supported-platforms#es6) +* diff --git a/aspnetcore/test/debug-aspnetcore-source.md b/aspnetcore/test/debug-aspnetcore-source.md index 6312aa224301..e58106e47134 100644 --- a/aspnetcore/test/debug-aspnetcore-source.md +++ b/aspnetcore/test/debug-aspnetcore-source.md @@ -51,3 +51,4 @@ If you have debugged an app before with the previous version of .NET, delete the * [Limitations of the 'Suppress JIT optimization' option](/visualstudio/debugger/jit-optimization-and-debugging#limitations-of-the-suppress-jit-optimization-option) To set `COMPlus_ReadyToRun` to `0` * * [Test Execution with Hot Reload](/visualstudio/test/test-execution-with-hot-reload) +* diff --git a/aspnetcore/toc.yml b/aspnetcore/toc.yml index 4211f1df8026..a0de5b58298e 100644 --- a/aspnetcore/toc.yml +++ b/aspnetcore/toc.yml @@ -1182,6 +1182,8 @@ items: uid: web-api/http-repl/telemetry - name: Test Minimal API uid: fundamentals/minimal-apis/test-min-api + - name: Blazor tests + uid: blazor/test - name: Razor Pages unit tests uid: test/razor-pages-tests - name: MVC controllers unit tests