From f7346665da1cb007518b71e5333e860669966278 Mon Sep 17 00:00:00 2001 From: guardrex <1622880+guardrex@users.noreply.github.com> Date: Fri, 15 Nov 2024 08:58:47 -0500 Subject: [PATCH] Updates --- .openpublishing.redirection.json | 8 ++++---- ...{prerendering-and-integration.md => integration.md} | 4 ++-- aspnetcore/blazor/fundamentals/signalr.md | 2 +- .../host-and-deploy/multiple-hosted-webassembly.md | 4 ++-- aspnetcore/blazor/includes/prerendering.md | 2 +- aspnetcore/blazor/security/index.md | 6 ++---- .../security/webassembly/additional-scenarios.md | 2 +- aspnetcore/blazor/security/webassembly/index.md | 2 +- aspnetcore/migration/30-to-31.md | 2 +- .../views/tag-helpers/built-in/component-tag-helper.md | 10 +++++----- .../tag-helpers/built-in/persist-component-state.md | 8 ++++---- aspnetcore/mvc/views/view-components.md | 4 ++-- aspnetcore/release-notes/aspnetcore-3.1.md | 2 +- aspnetcore/release-notes/aspnetcore-6.0.md | 2 +- aspnetcore/toc.yml | 2 +- .../choose-web-ui/includes/choose-web-ui3-7.md | 4 +--- aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md | 2 +- 17 files changed, 31 insertions(+), 35 deletions(-) rename aspnetcore/blazor/components/{prerendering-and-integration.md => integration.md} (99%) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 962b7e7c25f6..faaf355d258b 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1117,7 +1117,7 @@ }, { "source_path": "aspnetcore/blazor/integrate-components.md", - "redirect_url": "/aspnet/core/blazor/components/prerendering-and-integration", + "redirect_url": "/aspnet/core/blazor/components/integration", "redirect_document_id": false }, { @@ -1157,7 +1157,7 @@ }, { "source_path": "aspnetcore/blazor/components/integrate-components-into-razor-pages-and-mvc-apps.md", - "redirect_url": "/aspnet/core/blazor/components/prerendering-and-integration", + "redirect_url": "/aspnet/core/blazor/components/integration", "redirect_document_id": false }, { @@ -1319,8 +1319,8 @@ "redirect_document_id": false }, { - "source_path": "aspnetcore/blazor/components/integration.md", - "redirect_url": "/aspnet/core/blazor/components/prerendering-and-integration", + "source_path": "aspnetcore/blazor/components/prerendering-and-integration.md", + "redirect_url": "/aspnet/core/blazor/components/integration", "redirect_document_id": false } ] diff --git a/aspnetcore/blazor/components/prerendering-and-integration.md b/aspnetcore/blazor/components/integration.md similarity index 99% rename from aspnetcore/blazor/components/prerendering-and-integration.md rename to aspnetcore/blazor/components/integration.md index 15c8f4e9974c..824313ef36de 100644 --- a/aspnetcore/blazor/components/prerendering-and-integration.md +++ b/aspnetcore/blazor/components/integration.md @@ -1,12 +1,12 @@ --- -title: Prerender and integrate ASP.NET Core Razor components +title: Integrate ASP.NET Core Razor components author: guardrex description: Learn about Razor component integration scenarios for Blazor apps, including prerendering of Razor components on the server. monikerRange: '>= aspnetcore-3.1' ms.author: riande ms.custom: mvc ms.date: 02/09/2024 -uid: blazor/components/prerendering-and-integration +uid: blazor/components/integration zone_pivot_groups: blazor-hosting-models --- # Prerender and integrate ASP.NET Core Razor components diff --git a/aspnetcore/blazor/fundamentals/signalr.md b/aspnetcore/blazor/fundamentals/signalr.md index 151e764a0a87..ce99003507aa 100644 --- a/aspnetcore/blazor/fundamentals/signalr.md +++ b/aspnetcore/blazor/fundamentals/signalr.md @@ -156,7 +156,7 @@ If prerendering is configured, prerendering occurs before the client connection If prerendering is configured, prerendering occurs before the client connection to the server is established. For more information, see the following articles: * -* +* :::moniker-end diff --git a/aspnetcore/blazor/host-and-deploy/multiple-hosted-webassembly.md b/aspnetcore/blazor/host-and-deploy/multiple-hosted-webassembly.md index 0f416370df22..29fd719339eb 100644 --- a/aspnetcore/blazor/host-and-deploy/multiple-hosted-webassembly.md +++ b/aspnetcore/blazor/host-and-deploy/multiple-hosted-webassembly.md @@ -66,7 +66,7 @@ The preceding configurations are beyond the scope of this article. For more info * [Host and deploy articles](xref:host-and-deploy/index) * -* +* Use an existing hosted Blazor WebAssembly [solution](xref:blazor/tooling#visual-studio-solution-file-sln) or create a [new hosted Blazor WebAssembly solution](xref:blazor/tooling) from the Blazor WebAssembly project template by passing the `-ho|--hosted` option if using the .NET CLI or selecting the **ASP.NET Core Hosted** checkbox in Visual Studio when the project is created in the IDE. @@ -453,7 +453,7 @@ public class HomeController : Controller > [!NOTE] > The preceding `Index` view is a minimal example purely for demonstration purposes. If the app requires additional MVC assets, such as a layout, styles, scripts, and imports, obtain them from an app created from the MVC project template. For more information, see . -For more information on using the Razor components from either of the client apps in pages or views of the server app, see . +For more information on using the Razor components from either of the client apps in pages or views of the server app, see . ## Run the app diff --git a/aspnetcore/blazor/includes/prerendering.md b/aspnetcore/blazor/includes/prerendering.md index 42dee80c0325..719501f2e6b9 100644 --- a/aspnetcore/blazor/includes/prerendering.md +++ b/aspnetcore/blazor/includes/prerendering.md @@ -9,7 +9,7 @@ :::moniker range="< aspnetcore-8.0" -*This section applies to server-side apps and hosted Blazor WebAssembly apps that prerender Razor components. Prerendering is covered in .* +*This section applies to server-side apps and hosted Blazor WebAssembly apps that prerender Razor components. Prerendering is covered in .* :::moniker-end diff --git a/aspnetcore/blazor/security/index.md b/aspnetcore/blazor/security/index.md index 9ac8358aed38..bd6c3be32b6a 100644 --- a/aspnetcore/blazor/security/index.md +++ b/aspnetcore/blazor/security/index.md @@ -20,18 +20,16 @@ Security scenarios differ between authorization code running server-side and cli If authorization rule enforcement must be guaranteed, don't implement authorization checks in client-side code. Build a Blazor Web App that only relies on server-side rendering (SSR) for authorization checks and rule enforcement. -[Razor Pages authorization conventions](xref:security/authorization/razor-pages-authorization) don't apply to routable Razor components. If a non-routable Razor component is [embedded in a page of a Razor Pages app](xref:blazor/components/integration), the page's authorization conventions indirectly affect the Razor component along with the rest of the page's content. - :::moniker-end :::moniker range="< aspnetcore-8.0" If authorization rule enforcement and the security of data and code must be guaranteed, don't develop a client-side app. Build a Blazor Server app. -[Razor Pages authorization conventions](xref:security/authorization/razor-pages-authorization) don't apply to routable Razor components. If a non-routable Razor component is [embedded in a page of a Razor Pages app](xref:blazor/components/prerendering-and-integration), the page's authorization conventions indirectly affect the Razor component along with the rest of the page's content. - :::moniker-end +[Razor Pages authorization conventions](xref:security/authorization/razor-pages-authorization) don't apply to routable Razor components. If a non-routable Razor component is [embedded in a page of a Razor Pages app](xref:blazor/components/integration), the page's authorization conventions indirectly affect the Razor component along with the rest of the page's content. + :::moniker range="< aspnetcore-8.0" ASP.NET Core Identity is designed to work in the context of HTTP request and response communication, which generally isn't the Blazor app client-server communication model. ASP.NET Core apps that use ASP.NET Core Identity for user management should use Razor Pages instead of Razor components for Identity-related UI, such as user registration, login, logout, and other user management tasks. Building Razor components that directly handle Identity tasks is possible for several scenarios but isn't recommended or supported by Microsoft. diff --git a/aspnetcore/blazor/security/webassembly/additional-scenarios.md b/aspnetcore/blazor/security/webassembly/additional-scenarios.md index c7d8dfd2db7f..9b3c325a6d0f 100644 --- a/aspnetcore/blazor/security/webassembly/additional-scenarios.md +++ b/aspnetcore/blazor/security/webassembly/additional-scenarios.md @@ -1283,7 +1283,7 @@ To configure a Blazor WebAssembly app to use the [ASP.NET Core gRPC framework](x :::moniker range="< aspnetcore-8.0" > [!NOTE] -> Prerendering is enabled by default in hosted Blazor WebAssembly apps, so you must account for the component rendering first from the server and then from the client. Any prerendered state should flow to the client so that it can be reused. For more information, see . +> Prerendering is enabled by default in hosted Blazor WebAssembly apps, so you must account for the component rendering first from the server and then from the client. Any prerendered state should flow to the client so that it can be reused. For more information, see . :::moniker-end diff --git a/aspnetcore/blazor/security/webassembly/index.md b/aspnetcore/blazor/security/webassembly/index.md index 8d855eb38f8f..1941588a1270 100644 --- a/aspnetcore/blazor/security/webassembly/index.md +++ b/aspnetcore/blazor/security/webassembly/index.md @@ -220,7 +220,7 @@ For examples, see the following resources: :::moniker range="< aspnetcore-8.0" -[Prerendering](xref:blazor/components/prerendering-and-integration) isn't supported for authentication endpoints (`/authentication/` path segment). +[Prerendering](xref:blazor/components/integration) isn't supported for authentication endpoints (`/authentication/` path segment). :::moniker-end diff --git a/aspnetcore/migration/30-to-31.md b/aspnetcore/migration/30-to-31.md index b1654b0e33c2..d56169d503ae 100644 --- a/aspnetcore/migration/30-to-31.md +++ b/aspnetcore/migration/30-to-31.md @@ -112,7 +112,7 @@ ASP.NET Core 3.1 introduces a `Component` Tag Helper. The Tag Helper can replace + ``` -For more information, see . +For more information, see . ## ASP.NET Core Module (ANCM) diff --git a/aspnetcore/mvc/views/tag-helpers/built-in/component-tag-helper.md b/aspnetcore/mvc/views/tag-helpers/built-in/component-tag-helper.md index c4c3e232d3f1..65c72e56e105 100644 --- a/aspnetcore/mvc/views/tag-helpers/built-in/component-tag-helper.md +++ b/aspnetcore/mvc/views/tag-helpers/built-in/component-tag-helper.md @@ -24,14 +24,14 @@ Follow the guidance in the *Use non-routable components in pages or views* secti Follow the guidance in the *Configuration* section for either: -* [Blazor Server](xref:blazor/components/prerendering-and-integration?pivots=server): Integrate routable and non-routable Razor components into Razor Pages and MVC apps. -* [Blazor WebAssembly](xref:blazor/components/prerendering-and-integration?pivots=webassembly): Integrate Razor components from a hosted Blazor WebAssembly solution into Razor Pages and MVC apps. +* [Blazor Server](xref:blazor/components/integration?pivots=server): Integrate routable and non-routable Razor components into Razor Pages and MVC apps. +* [Blazor WebAssembly](xref:blazor/components/integration?pivots=webassembly): Integrate Razor components from a hosted Blazor WebAssembly solution into Razor Pages and MVC apps. :::moniker-end :::moniker range="< aspnetcore-5.0" -Follow the guidance in the *Configuration* section of the article. +Follow the guidance in the *Configuration* section of the article. :::moniker-end @@ -343,7 +343,7 @@ The preceding example assumes that the `ParameterComponent` component is in the :::moniker range=">= aspnetcore-6.0 < aspnetcore-8.0" * -* +* * * * @@ -352,7 +352,7 @@ The preceding example assumes that the `ParameterComponent` component is in the :::moniker range="< aspnetcore-6.0" -* +* * * * diff --git a/aspnetcore/mvc/views/tag-helpers/built-in/persist-component-state.md b/aspnetcore/mvc/views/tag-helpers/built-in/persist-component-state.md index 88f45aa72358..7f243b902a49 100644 --- a/aspnetcore/mvc/views/tag-helpers/built-in/persist-component-state.md +++ b/aspnetcore/mvc/views/tag-helpers/built-in/persist-component-state.md @@ -24,8 +24,8 @@ Follow the guidance in the *Use non-routable components in pages or views* secti Follow the guidance in the *Configuration* section for either: -* [Blazor WebAssembly](xref:blazor/components/prerendering-and-integration?pivots=webassembly) -* [Blazor Server](xref:blazor/components/prerendering-and-integration?pivots=server) +* [Blazor WebAssembly](xref:blazor/components/integration?pivots=webassembly) +* [Blazor Server](xref:blazor/components/integration?pivots=server) :::moniker-end @@ -71,7 +71,7 @@ In `Pages/_Host.cshtml` of Blazor apps that are either WebAssembly prerendered ( Decide what state to persist using the service. [`PersistentComponentState.RegisterOnPersisting`](xref:Microsoft.AspNetCore.Components.PersistentComponentState.RegisterOnPersisting%2A) registers a callback to persist the component state before the app is paused. The state is retrieved when the application resumes. -For more information and examples, see . +For more information and examples, see . :::moniker-end @@ -90,7 +90,7 @@ For more information and examples, see -* +* * * * diff --git a/aspnetcore/mvc/views/view-components.md b/aspnetcore/mvc/views/view-components.md index f274fa1ab29e..76d079a1217a 100644 --- a/aspnetcore/mvc/views/view-components.md +++ b/aspnetcore/mvc/views/view-components.md @@ -350,7 +350,7 @@ A view component consists of two parts: Like controllers, a view component can be a POCO, but most developers take advantage of the methods and properties available by deriving from . -When considering if view components meet an app's specifications, consider using Razor components instead. Razor components also combine markup with C# code to produce reusable UI units. Razor components are designed for developer productivity when providing client-side UI logic and composition. For more information, see . For information on how to incorporate Razor components into an MVC or Razor Pages app, see . +When considering if view components meet an app's specifications, consider using Razor components instead. Razor components also combine markup with C# code to produce reusable UI units. Razor components are designed for developer productivity when providing client-side UI logic and composition. For more information, see . For information on how to incorporate Razor components into an MVC or Razor Pages app, see . ## Create a view component @@ -655,7 +655,7 @@ View components are intended anywhere you have reusable rendering logic that's t A view component consists of two parts: the class (typically derived from ) and the result it returns (typically a view). Like controllers, a view component can be a [POCO](https://stackoverflow.com/questions/250001/poco-definition), but most developers take advantage of the methods and properties available by deriving from `ViewComponent`. -When considering if view components meet an app's specifications, consider using Razor components instead. Razor components also combine markup with C# code to produce reusable UI units. Razor components are designed for developer productivity when providing client-side UI logic and composition. For more information, see . For information on how to incorporate Razor components into an MVC or Razor Pages app, see . +When considering if view components meet an app's specifications, consider using Razor components instead. Razor components also combine markup with C# code to produce reusable UI units. Razor components are designed for developer productivity when providing client-side UI logic and composition. For more information, see . For information on how to incorporate Razor components into an MVC or Razor Pages app, see . ## Creating a view component diff --git a/aspnetcore/release-notes/aspnetcore-3.1.md b/aspnetcore/release-notes/aspnetcore-3.1.md index cd7e57adb8e0..7af7a3eb2a31 100644 --- a/aspnetcore/release-notes/aspnetcore-3.1.md +++ b/aspnetcore/release-notes/aspnetcore-3.1.md @@ -34,7 +34,7 @@ For example, prerender a `Counter` component with an increment amount (`Incremen param-IncrementAmount="10" /> ``` -For more information, see [Integrate components into Razor Pages and MVC apps](xref:blazor/components/prerendering-and-integration?view=aspnetcore-3.1&preserve-view=true). +For more information, see [Integrate components into Razor Pages and MVC apps](xref:blazor/components/integration?view=aspnetcore-3.1&preserve-view=true). ## Support for shared queues in HTTP.sys diff --git a/aspnetcore/release-notes/aspnetcore-6.0.md b/aspnetcore/release-notes/aspnetcore-6.0.md index fd58ee567efc..edd8d15b8380 100644 --- a/aspnetcore/release-notes/aspnetcore-6.0.md +++ b/aspnetcore/release-notes/aspnetcore-6.0.md @@ -160,7 +160,7 @@ Blazor WebAssembly supports ahead-of-time (AOT) compilation, where you can compi ### Persist prerendered state -Blazor supports persisting state in a prerendered page so that the state doesn't need to be recreated when the app is fully loaded. For more information, see . +Blazor supports persisting state in a prerendered page so that the state doesn't need to be recreated when the app is fully loaded. For more information, see . ### Error boundaries diff --git a/aspnetcore/toc.yml b/aspnetcore/toc.yml index 5381bb5c5532..00da4e252abb 100644 --- a/aspnetcore/toc.yml +++ b/aspnetcore/toc.yml @@ -547,7 +547,7 @@ items: - name: QuickGrid component uid: blazor/components/quickgrid - name: Prerender and integrate components - uid: blazor/components/prerendering-and-integration + uid: blazor/components/integration - name: Class libraries uid: blazor/components/class-libraries - name: Class libraries with static SSR diff --git a/aspnetcore/tutorials/choose-web-ui/includes/choose-web-ui3-7.md b/aspnetcore/tutorials/choose-web-ui/includes/choose-web-ui3-7.md index f39a8aba5e3f..905f79fcf100 100644 --- a/aspnetcore/tutorials/choose-web-ui/includes/choose-web-ui3-7.md +++ b/aspnetcore/tutorials/choose-web-ui/includes/choose-web-ui3-7.md @@ -80,15 +80,13 @@ Benefits for MVC or Razor Pages plus Blazor, in addition to MVC or Razor Pages b To get started with ASP.NET Core MVC or Razor Pages plus Blazor, see . -To get started with ASP.NET Core MVC or Razor Pages plus Blazor, see . - ## Next steps For more information, see: * * -* +* * :::moniker-end diff --git a/aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md b/aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md index e0536e8341fe..d51da79cb252 100644 --- a/aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md +++ b/aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md @@ -48,7 +48,7 @@ Welcome to what's new in the ASP.NET Core docs for June 2024. This article lists - Update Apache coverage (drop CentOS mentions) - Fix spacing in Apache configuration example - - Import-Export interop: collocated JS with RCL -- - Use 'reconnection UI' for all references +- - Use 'reconnection UI' for all references - - Interactive SSR RCs in global WASM/Auto projects - - Simplified auth state serialization for BWAs - - Change Tooling article content layout