From 93d0aea88741fb1831094711649dee6347960e21 Mon Sep 17 00:00:00 2001 From: guardrex <1622880+guardrex@users.noreply.github.com> Date: Mon, 18 Sep 2023 16:10:05 -0400 Subject: [PATCH] Disable prerendering update 8.0 --- aspnetcore/blazor/components/render-modes.md | 15 +++++++++++++++ aspnetcore/blazor/security/server/index.md | 10 ++++++++-- aspnetcore/blazor/state-management.md | 10 ++++++++-- 3 files changed, 31 insertions(+), 4 deletions(-) diff --git a/aspnetcore/blazor/components/render-modes.md b/aspnetcore/blazor/components/render-modes.md index 0cee739a4a68..5930dae838ec 100644 --- a/aspnetcore/blazor/components/render-modes.md +++ b/aspnetcore/blazor/components/render-modes.md @@ -169,6 +169,21 @@ From the component definition: In the preceding example, the `{ROUTE}` placeholder is the route template. +To disable prerendering for the entire app, indicate the render mode at the highest-level component in the app's component hierarchy that isn't a root component (root components can't be interactive). Typically, this is where the `Routes` component is used in the `App` component (`Components/App.razor`) for apps based on the Blazor Web App project template: + +```razor + +``` + +Also, disable prerendering for the `HeadOutlet` component: + +```razor + +``` + +> [!NOTE] +> The preceding syntax will be simplified in an upcoming preview release. + > [!NOTE] > During .NET 8 *Release Candidate 1*, use the following values: > diff --git a/aspnetcore/blazor/security/server/index.md b/aspnetcore/blazor/security/server/index.md index 1df2b988802e..db3074032834 100644 --- a/aspnetcore/blazor/security/server/index.md +++ b/aspnetcore/blazor/security/server/index.md @@ -617,10 +617,16 @@ To avoid showing unauthorized content while prerendering with a [custom `Authent :::moniker range=">= aspnetcore-8.0" -* Disable prerendering: Pass `false` to a server render mode attribute placed in the `Routes` component (`Routes.razor`): +* Disable prerendering: Indicate the render mode with the `prerender` parameter set to `false` at the highest-level component in the app's component hierarchy that isn't a root component (root components can't be interactive). Typically, this is where the `Routes` component is used in the `App` component (`Components/App.razor`) for apps based on the Blazor Web App project template: + ```razor + ``` - @attribute [RenderModeServer(false)] + + Also, disable prerendering for the `HeadOutlet` component: + + ```razor + ``` :::moniker-end diff --git a/aspnetcore/blazor/state-management.md b/aspnetcore/blazor/state-management.md index f24793162994..d9391d826389 100644 --- a/aspnetcore/blazor/state-management.md +++ b/aspnetcore/blazor/state-management.md @@ -269,10 +269,16 @@ One way to resolve the error is to disable prerendering. This is usually the bes :::moniker range=">= aspnetcore-8.0" -To disable prerendering, pass `false` to a server render mode attribute placed in the `Routes` component (`Routes.razor`): +To disable prerendering, indicate the render mode with the `prerender` parameter set to `false` at the highest-level component in the app's component hierarchy that isn't a root component (root components can't be interactive). Typically, this is where the `Routes` component is used in the `App` component (`Components/App.razor`) for apps based on the Blazor Web App project template: +```razor + ``` -@attribute [RenderModeServer(false)] + +Also, disable prerendering for the `HeadOutlet` component: + +```razor + ``` :::moniker-end