Skip to content

Commit 6fa420b

Browse files
authored
Content follow-up updates (8.0) (#31622)
1 parent 795a017 commit 6fa420b

23 files changed

+121
-117
lines changed

aspnetcore/blazor/components/built-in-components.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,21 @@ The following built-in Razor components are provided by the Blazor framework:
1616

1717
:::moniker range=">= aspnetcore-8.0"
1818

19-
<!-- UPDATE 8.0 Confirm/update list -->
19+
<!-- Link for FormMappingValidator. Addition to docs tracked by
20+
https://github.com/dotnet/AspNetCore.Docs/issues/31621
21+
22+
* [`FormMappingValidator`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
23+
-->
2024

2125
* [`App`](xref:blazor/project-structure)
2226
* [`AntiforgeryToken`](xref:blazor/forms/index#antiforgery-support)
2327
* [`Authentication`](xref:blazor/security/webassembly/index#authentication-component)
2428
* [`AuthorizeView`](xref:blazor/security/index#authorizeview-component)
2529
* [`CascadingValue`](xref:blazor/components/cascading-values-and-parameters#cascadingvalue-component)
30+
* [`DataAnnotationsValidator`](xref:blazor/forms/validation#data-annotations-validator-component-and-custom-validation)
2631
* [`DynamicComponent`](xref:blazor/components/dynamiccomponent)
32+
* [`Editor<T>`](xref:blazor/forms/binding#nest-and-bind-forms)
33+
* [`EditForm`](xref:blazor/forms/binding#editformeditcontext-model)
2734
* [`ErrorBoundary`](xref:blazor/fundamentals/handle-errors#error-boundaries)
2835
* [`FocusOnNavigate`](xref:blazor/fundamentals/routing#focus-an-element-on-navigation)
2936
* [`HeadContent`](xref:blazor/components/control-head-content)
@@ -47,6 +54,7 @@ The following built-in Razor components are provided by the Blazor framework:
4754
* [`RouteView`](xref:blazor/fundamentals/routing#route-templates)
4855
* [`SectionContent`](xref:blazor/components/sections)
4956
* [`SectionOutlet`](xref:blazor/components/sections)
57+
* [`ValidationSummary`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
5058
* [`Virtualize`](xref:blazor/components/virtualization)
5159

5260
:::moniker-end
@@ -57,7 +65,9 @@ The following built-in Razor components are provided by the Blazor framework:
5765
* [`Authentication`](xref:blazor/security/webassembly/index#authentication-component)
5866
* [`AuthorizeView`](xref:blazor/security/index#authorizeview-component)
5967
* [`CascadingValue`](xref:blazor/components/cascading-values-and-parameters#cascadingvalue-component)
68+
* [`DataAnnotationsValidator`](xref:blazor/forms/validation#data-annotations-validator-component-and-custom-validation)
6069
* [`DynamicComponent`](xref:blazor/components/dynamiccomponent)
70+
* [`EditForm`](xref:blazor/forms/binding#editformeditcontext-model)
6171
* [`ErrorBoundary`](xref:blazor/fundamentals/handle-errors#error-boundaries)
6272
* [`FocusOnNavigate`](xref:blazor/fundamentals/routing#focus-an-element-on-navigation)
6373
* [`HeadContent`](xref:blazor/components/control-head-content)
@@ -79,6 +89,7 @@ The following built-in Razor components are provided by the Blazor framework:
7989
* [`QuickGrid`](xref:blazor/components/quickgrid)
8090
* [`Router`](xref:blazor/fundamentals/routing#route-templates)
8191
* [`RouteView`](xref:blazor/fundamentals/routing#route-templates)
92+
* [`ValidationSummary`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
8293
* [`Virtualize`](xref:blazor/components/virtualization)
8394

8495
:::moniker-end
@@ -89,7 +100,9 @@ The following built-in Razor components are provided by the Blazor framework:
89100
* [`Authentication`](xref:blazor/security/webassembly/index#authentication-component)
90101
* [`AuthorizeView`](xref:blazor/security/index#authorizeview-component)
91102
* [`CascadingValue`](xref:blazor/components/cascading-values-and-parameters#cascadingvalue-component)
103+
* [`DataAnnotationsValidator`](xref:blazor/forms/validation#data-annotations-validator-component-and-custom-validation)
92104
* [`DynamicComponent`](xref:blazor/components/dynamiccomponent)
105+
* [`EditForm`](xref:blazor/forms/binding#editformeditcontext-model)
93106
* [`ErrorBoundary`](xref:blazor/fundamentals/handle-errors#error-boundaries)
94107
* [`FocusOnNavigate`](xref:blazor/fundamentals/routing#focus-an-element-on-navigation)
95108
* [`HeadContent`](xref:blazor/components/control-head-content)
@@ -110,6 +123,7 @@ The following built-in Razor components are provided by the Blazor framework:
110123
* [`PageTitle`](xref:blazor/components/control-head-content)
111124
* [`Router`](xref:blazor/fundamentals/routing#route-templates)
112125
* [`RouteView`](xref:blazor/fundamentals/routing#route-templates)
126+
* [`ValidationSummary`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
113127
* [`Virtualize`](xref:blazor/components/virtualization)
114128

115129
:::moniker-end
@@ -120,6 +134,8 @@ The following built-in Razor components are provided by the Blazor framework:
120134
* [`Authentication`](xref:blazor/security/webassembly/index#authentication-component)
121135
* [`AuthorizeView`](xref:blazor/security/index#authorizeview-component)
122136
* [`CascadingValue`](xref:blazor/components/cascading-values-and-parameters#cascadingvalue-component)
137+
* [`DataAnnotationsValidator`](xref:blazor/forms/validation#data-annotations-validator-component-and-custom-validation)
138+
* [`EditForm`](xref:blazor/forms/binding#editformeditcontext-model)
123139
* [`InputCheckbox`](xref:blazor/forms/input-components)
124140
* [`InputDate`](xref:blazor/forms/input-components)
125141
* [`InputFile`](xref:blazor/file-uploads)
@@ -135,6 +151,7 @@ The following built-in Razor components are provided by the Blazor framework:
135151
* [`NavMenu`](xref:blazor/fundamentals/routing#navlink-and-navmenu-components)
136152
* [`Router`](xref:blazor/fundamentals/routing#route-templates)
137153
* [`RouteView`](xref:blazor/fundamentals/routing#route-templates)
154+
* [`ValidationSummary`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
138155
* [`Virtualize`](xref:blazor/components/virtualization)
139156

140157
:::moniker-end
@@ -145,6 +162,8 @@ The following built-in Razor components are provided by the Blazor framework:
145162
* [`Authentication`](xref:blazor/security/webassembly/index#authentication-component)
146163
* [`AuthorizeView`](xref:blazor/security/index#authorizeview-component)
147164
* [`CascadingValue`](xref:blazor/components/cascading-values-and-parameters#cascadingvalue-component)
165+
* [`DataAnnotationsValidator`](xref:blazor/forms/validation#data-annotations-validator-component-and-custom-validation)
166+
* [`EditForm`](xref:blazor/forms/binding#editformeditcontext-model)
148167
* [`InputCheckbox`](xref:blazor/forms/input-components)
149168
* [`InputDate`](xref:blazor/forms/input-components)
150169
* [`InputNumber`](xref:blazor/forms/input-components)
@@ -159,5 +178,6 @@ The following built-in Razor components are provided by the Blazor framework:
159178
* [`NavMenu`](xref:blazor/fundamentals/routing#navlink-and-navmenu-components)
160179
* [`Router`](xref:blazor/fundamentals/routing#route-templates)
161180
* [`RouteView`](xref:blazor/fundamentals/routing#route-templates)
181+
* [`ValidationSummary`](xref:blazor/forms/validation#validation-summary-and-validation-message-components)
162182

163183
:::moniker-end

aspnetcore/blazor/components/render-modes.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -227,8 +227,6 @@ Additional information on render mode propagation is provided in the [Render mod
227227

228228
Prerendering is enabled by default for interactive components.
229229

230-
<!-- UPDATE 8.0 Are there any simplifications for these at RTM? -->
231-
232230
To disable prerendering for a *component instance*, pass the `prerender` flag with a value of `false` to the render mode:
233231

234232
* `<... @rendermode="new InteractiveServerRenderMode(prerender: false)" />`

aspnetcore/blazor/forms/validation.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -331,7 +331,7 @@ The validation for the `Defense` ship classification only occurs on the server i
331331
> For more information on security, see:
332332
>
333333
> * <xref:blazor/security/index> (and the other articles in the Blazor *Security and Identity* node)
334-
> * [Microsoft identity platform documentation](/azure/active-directory/develop/)
334+
> * [Microsoft identity platform documentation](/entra/identity-platform/)
335335
336336
`Controllers/StarshipValidation.cs`:
337337

@@ -911,9 +911,7 @@ Control the style of validation messages in the app's stylesheet (`wwwroot/css/a
911911

912912
## Determine if a form field is valid
913913

914-
<!-- UPDATE 8.0 Add API cross-link -->
915-
916-
Use `EditContext.IsValid(fieldIdentifier)` to determine if a field is valid without obtaining validation messages.
914+
Use <xref:Microsoft.AspNetCore.Components.Forms.EditContext.IsValid%2A?displayProperty=nameWithType> to determine if a field is valid without obtaining validation messages.
917915

918916
<span aria-hidden="true">❌</span> Supported, but not recommended:
919917

aspnetcore/blazor/fundamentals/handle-errors.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -298,14 +298,14 @@ Use the <xref:Microsoft.AspNetCore.Components.Endpoints.RazorComponentsServiceOp
298298
The following example enables detailed errors:
299299

300300
```csharp
301-
builder.Services.AddRazorComponents(options => options.DetailedErrors = true);
301+
builder.Services.AddRazorComponents(options =>
302+
options.DetailedErrors = builder.Environment.IsDevelopment());
302303
```
303304

304-
<!-- UPDATE 8.0 We need to flesh out this warning with the consequences
305-
of enabling detailed errors in production. -->
306-
307305
> [!WARNING]
308-
> Only enable detailed errors in the `Development` environment.
306+
> **Only enable detailed errors in the `Development` environment.** Detailed errors may contain sensitive information about the app that malicious users can use in an attack.
307+
>
308+
> The preceding example provides a degree of safety by setting the value of <xref:Microsoft.AspNetCore.Components.Endpoints.RazorComponentsServiceOptions.DetailedErrors> based on the value returned by <xref:Microsoft.Extensions.Hosting.HostEnvironmentEnvExtensions.IsDevelopment%2A>. When the app is in the `Development` environment, <xref:Microsoft.AspNetCore.Components.Endpoints.RazorComponentsServiceOptions.DetailedErrors> is set to `true`. This approach isn't foolproof because it's possible to host a production app on a public server in the `Development` environment.
309309
310310
:::moniker-end
311311

aspnetcore/blazor/fundamentals/signalr.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -283,10 +283,6 @@ Configure <xref:Microsoft.AspNetCore.Builder.ComponentEndpointRouteBuilderExtens
283283
* <xref:Microsoft.AspNetCore.Http.Connections.HttpConnectionDispatcherOptions.TransportSendTimeout>
284284
* <xref:Microsoft.AspNetCore.Http.Connections.HttpConnectionDispatcherOptions.WebSockets> (*Read only*)
285285

286-
<!-- UPDATE 8.0 Confirm with the PU because there's a report at
287-
https://github.com/dotnet/AspNetCore.Docs/issues/31113
288-
that this doesn't configure Blazor's hub options. -->
289-
290286
Place the call to `app.MapBlazorHub` after the call to `app.MapRazorComponents` in the app's `Program` file:
291287

292288
```csharp

aspnetcore/blazor/host-and-deploy/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,10 +150,6 @@ For the second option, which is the usual approach taken, the app sets the base
150150

151151
### Server-side Blazor
152152

153-
<!-- UPDATE 8.0 Check via PU questions or when the App Base Path issue
154-
https://github.com/dotnet/AspNetCore.Docs/issues/30043
155-
is worked. -->
156-
157153
Map the SignalR hub of a server-side Blazor app by passing the path to <xref:Microsoft.AspNetCore.Builder.ComponentEndpointRouteBuilderExtensions.MapBlazorHub%2A> in the `Program` file:
158154

159155
```csharp

aspnetcore/blazor/host-and-deploy/webassembly-deployment-layout.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,7 @@ The approach demonstrated in this article serves as a starting point for develop
3232
3333
## Experimental NuGet package and sample app
3434

35-
<!-- UPDATE 8.0 Confirm that the package on NuGet indicates
36-
support for only 6.0 and 7.0 at 8.0 RTM. -->
37-
38-
The approach described in this article is used by the *experimental* [`Microsoft.AspNetCore.Components.WebAssembly.MultipartBundle` package (NuGet.org)](https://www.nuget.org/packages/Microsoft.AspNetCore.Components.WebAssembly.MultipartBundle) for .NET 6 and 7 apps. The package contains MSBuild targets to customize the Blazor publish output and a [JavaScript initializer](xref:blazor/js-interop/index#javascript-initializers) to use a custom [boot resource loader](xref:blazor/fundamentals/startup#load-boot-resources), each of which are described in detail later in this article.
35+
The approach described in this article is used by the *experimental* [`Microsoft.AspNetCore.Components.WebAssembly.MultipartBundle` package (NuGet.org)](https://www.nuget.org/packages/Microsoft.AspNetCore.Components.WebAssembly.MultipartBundle) for apps targeting .NET 6 or later. The package contains MSBuild targets to customize the Blazor publish output and a [JavaScript initializer](xref:blazor/js-interop/index#javascript-initializers) to use a custom [boot resource loader](xref:blazor/fundamentals/startup#load-boot-resources), each of which are described in detail later in this article.
3936

4037
[Experimental code (includes the NuGet package reference source and `CustomPackagedApp` sample app)](https://github.com/aspnet/AspLabs/tree/main/src/BlazorWebAssemblyCustomInitialization)
4138

aspnetcore/blazor/hybrid/security/index.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -47,20 +47,20 @@ For additional guidance, see the following resources:
4747

4848
:::zone pivot="wpf"
4949

50-
WPF apps use the [Microsoft identity platform](/azure/active-directory/develop/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For guidance and examples, see the following resources:
50+
WPF apps use the [Microsoft identity platform](/entra/identity-platform/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For guidance and examples, see the following resources:
5151

52-
* [Overview of the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview)
52+
* [Overview of the Microsoft Authentication Library (MSAL)](/entra/identity-platform/msal-overview)
5353
* [Add authentication to your Windows (WPF) app](/azure/developer/mobile-apps/azure-mobile-apps/quickstarts/wpf/authentication)
54-
* [Tutorial: Sign in users and call Microsoft Graph in Windows Presentation Foundation (WPF) desktop app](/azure/active-directory/develop/tutorial-v2-windows-desktop)
55-
* [Quickstart: Acquire a token and call Microsoft Graph API from a desktop application](/azure/active-directory/develop/desktop-app-quickstart?pivots=devlang-windows-desktop)
54+
* [Tutorial: Sign in users and call Microsoft Graph in Windows Presentation Foundation (WPF) desktop app](/entra/identity-platform/tutorial-v2-windows-desktop)
55+
* [Quickstart: Acquire a token and call Microsoft Graph API from a desktop application](/entra/identity-platform/index-desktop)
5656
* [Quickstart: Set up sign in for a desktop app using Azure Active Directory B2C](/azure/active-directory-b2c/quickstart-native-app-desktop)
5757
* [Configure authentication in a sample WPF desktop app by using Azure AD B2C](/azure/active-directory-b2c/configure-authentication-sample-wpf-desktop-app)
5858

5959
:::zone-end
6060

6161
:::zone pivot="winforms"
6262

63-
Windows Forms apps use the [Microsoft identity platform](/azure/active-directory/develop/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For more information, see [Overview of the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview).
63+
Windows Forms apps use the [Microsoft identity platform](/entra/identity-platform/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For more information, see [Overview of the Microsoft Authentication Library (MSAL)](/entra/identity-platform/msal-overview).
6464

6565
:::zone-end
6666

@@ -578,20 +578,20 @@ For additional guidance, see the following resources:
578578

579579
:::zone pivot="wpf"
580580

581-
WPF apps use the [Microsoft identity platform](/azure/active-directory/develop/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For guidance and examples, see the following resources:
581+
WPF apps use the [Microsoft identity platform](/entra/identity-platform/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For guidance and examples, see the following resources:
582582

583-
* [Overview of the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview)
583+
* [Overview of the Microsoft Authentication Library (MSAL)](/entra/identity-platform/msal-overview)
584584
* [Add authentication to your Windows (WPF) app](/azure/developer/mobile-apps/azure-mobile-apps/quickstarts/wpf/authentication)
585-
* [Tutorial: Sign in users and call Microsoft Graph in Windows Presentation Foundation (WPF) desktop app](/azure/active-directory/develop/tutorial-v2-windows-desktop)
586-
* [Quickstart: Acquire a token and call Microsoft Graph API from a desktop application](/azure/active-directory/develop/desktop-app-quickstart?pivots=devlang-windows-desktop)
585+
* [Tutorial: Sign in users and call Microsoft Graph in Windows Presentation Foundation (WPF) desktop app](/entra/identity-platform/tutorial-v2-windows-desktop)
586+
* [Quickstart: Acquire a token and call Microsoft Graph API from a desktop application](/entra/identity-platform/index-desktop)
587587
* [Quickstart: Set up sign in for a desktop app using Azure Active Directory B2C](/azure/active-directory-b2c/quickstart-native-app-desktop)
588588
* [Configure authentication in a sample WPF desktop app by using Azure AD B2C](/azure/active-directory-b2c/configure-authentication-sample-wpf-desktop-app)
589589

590590
:::zone-end
591591

592592
:::zone pivot="winforms"
593593

594-
Windows Forms apps use the [Microsoft identity platform](/azure/active-directory/develop/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For more information, see [Overview of the Microsoft Authentication Library (MSAL)](/azure/active-directory/develop/msal-overview).
594+
Windows Forms apps use the [Microsoft identity platform](/entra/identity-platform/) to integrate with Microsoft Entra (ME-ID) and AAD B2C. For more information, see [Overview of the Microsoft Authentication Library (MSAL)](/entra/identity-platform/msal-overview).
595595

596596
:::zone-end
597597

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
> [!IMPORTANT]
22
> If you don't have the authority to grant admin consent to the tenant in the last step of **API permissions** configuration because consent to use the app is delegated to users, then you must take the following additional steps:
33
>
4-
> * The app must use a [trusted publisher domain](/azure/active-directory/develop/howto-configure-publisher-domain).
4+
> * The app must use a [trusted publisher domain](/entra/identity-platform/howto-configure-publisher-domain).
55
> * In the **`Server`** app's configuration in the Azure portal, select **Expose an API**. Under **Authorized client applications**, select the button to **Add a client application**. Add the **`Client`** app's Application (client) ID (for example, `4369008b-21fa-427c-abaa-9b53bf58e538`).

aspnetcore/blazor/security/includes/troubleshoot.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ To enable debug or trace logging for Blazor WebAssembly authentication, see <xre
5151

5252
To resolve the error:
5353

54-
1. In the Azure portal, access the [app's manifest](/azure/active-directory/develop/reference-app-manifest).
55-
1. Set the [`allowPublicClient` attribute](/azure/active-directory/develop/reference-app-manifest#allowpublicclient-attribute) to `null` or `true`.
54+
1. In the Azure portal, access the [app's manifest](/entra/identity-platform/reference-app-manifest).
55+
1. Set the [`allowPublicClient` attribute](/entra/identity-platform/reference-app-manifest#allowpublicclient-attribute) to `null` or `true`.
5656

5757
### Cookies and site data
5858

0 commit comments

Comments
 (0)