Collection simplification (#34531)

Author: guardrex

aspnetcore/blazor/call-web-api.md

@@ -662,7 +662,7 @@ public class CookieHandler : DelegatingHandler
         HttpRequestMessage request, CancellationToken cancellationToken)
     {
         request.SetBrowserRequestCredentials(BrowserRequestCredentials.Include);
-        request.Headers.Add("X-Requested-With", ["XMLHttpRequest"]);
+        request.Headers.Add("X-Requested-With", [ "XMLHttpRequest" ]);
 
         return base.SendAsync(request, cancellationToken);
     }
@@ -694,7 +694,7 @@ When composing an <xref:System.Net.Http.HttpRequestMessage>, set the browser req
 var requestMessage = new HttpRequestMessage() { ... };
 
 requestMessage.SetBrowserRequestCredentials(BrowserRequestCredentials.Include);
-requestMessage.Headers.Add("X-Requested-With", ["XMLHttpRequest"]);
+requestMessage.Headers.Add("X-Requested-With", [ "XMLHttpRequest" ]);
 ```
 
 ## `HttpClient` and `HttpRequestMessage` with Fetch API request options

aspnetcore/blazor/components/class-libraries-and-static-server-side-rendering.md

@@ -93,11 +93,11 @@ Reusable Razor components may include forms (either `<form>` or `<EditForm>`), a
 Consider the following example:
 
 ```razor
-<EditForm Enhance FormName="NewProduct" Model="Model" OnValidSubmit="SaveProduct">
+<EditForm Enhance FormName="NewProduct" Model="Model" OnValidSubmit="Save">
     <DataAnnotationsValidator />
     <ValidationSummary />
 
-    <p><label>Name: <InputText @bind-Value="Item.Name" /></label></p>
+    <p><label>Name: <InputText @bind-Value="Model!.Name" /></label></p>
 
     <button type="submit">Submit</button>
 </EditForm>

aspnetcore/blazor/components/data-binding.md

@@ -399,6 +399,67 @@ Binding supports [`multiple`](https://developer.mozilla.org/docs/Web/HTML/Attrib
 
 `BindMultipleInput.razor`:
 
+:::moniker-end
+
+:::moniker range=">= aspnetcore-8.0"
+
+```razor
+@page "/bind-multiple-input"
+
+<h1>Bind Multiple <code>input</code>Example</h1>
+
+<p>
+    <label>
+        Select one or more cars: 
+        <select @onchange="SelectedCarsChanged" multiple>
+            <option value="audi">Audi</option>
+            <option value="jeep">Jeep</option>
+            <option value="opel">Opel</option>
+            <option value="saab">Saab</option>
+            <option value="volvo">Volvo</option>
+        </select>
+    </label>
+</p>
+
+<p>
+    Selected Cars: @string.Join(", ", SelectedCars)
+</p>
+
+<p>
+    <label>
+        Select one or more cities: 
+        <select @bind="SelectedCities" multiple>
+            <option value="bal">Baltimore</option>
+            <option value="la">Los Angeles</option>
+            <option value="pdx">Portland</option>
+            <option value="sf">San Francisco</option>
+            <option value="sea">Seattle</option>
+        </select>
+    </label>
+</p>
+
+<span>
+    Selected Cities: @string.Join(", ", SelectedCities)
+</span>
+
+@code {
+    public string[] SelectedCars { get; set; } = [];
+    public string[] SelectedCities { get; set; } = [ "bal", "sea" ];
+
+    private void SelectedCarsChanged(ChangeEventArgs e)
+    {
+        if (e.Value is not null)
+        {
+            SelectedCars = (string[])e.Value;
+        }
+    }
+}
+```
+
+:::moniker-end
+
+:::moniker range=">= aspnetcore-6.0 < aspnetcore-8.0"
+
 ```razor
 @page "/bind-multiple-input"
 
@@ -452,6 +513,10 @@ Binding supports [`multiple`](https://developer.mozilla.org/docs/Web/HTML/Attrib
 }
 ```
 
+:::moniker-end
+
+:::moniker range=">= aspnetcore-6.0"
+
 For information on how empty strings and `null` values are handled in data binding, see the [Binding `<select>` element options to C# object `null` values](#binding-select-element-options-to-c-object-null-values) section.
 
 :::moniker-end

aspnetcore/blazor/components/virtualization.md

@@ -214,7 +214,7 @@ Change the `OnInitialized` method lambda to see the component display strings:
 
 ```csharp
 protected override void OnInitialized() =>
-    stringList ??= new() { "Here's a string!", "Here's another string!" };
+    stringList ??= [ "Here's a string!", "Here's another string!" ];
 ```
 
 :::moniker-end

aspnetcore/blazor/forms/validation.md

@@ -353,6 +353,61 @@ The validation for the `Defense` ship classification only occurs on the server i
 
 `Controllers/StarshipValidation.cs`:
 
+:::moniker range=">= aspnetcore-8.0"
+
+```csharp
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using BlazorSample.Shared;
+
+namespace BlazorSample.Server.Controllers;
+
+[Authorize]
+[ApiController]
+[Route("[controller]")]
+public class StarshipValidationController(
+    ILogger<StarshipValidationController> logger) 
+    : ControllerBase
+{
+    static readonly string[] scopeRequiredByApi = [ "API.Access" ];
+
+    [HttpPost]
+    public async Task<IActionResult> Post(Starship model)
+    {
+        HttpContext.VerifyUserHasAnyAcceptedScope(scopeRequiredByApi);
+
+        try
+        {
+            if (model.Classification == "Defense" && 
+                string.IsNullOrEmpty(model.Description))
+            {
+                ModelState.AddModelError(nameof(model.Description),
+                    "For a 'Defense' ship " +
+                    "classification, 'Description' is required.");
+            }
+            else
+            {
+                logger.LogInformation("Processing the form asynchronously");
+
+                // async ...
+
+                return Ok(ModelState);
+            }
+        }
+        catch (Exception ex)
+        {
+            logger.LogError("Validation Error: {Message}", ex.Message);
+        }
+
+        return BadRequest(ModelState);
+    }
+}
+```
+
+:::moniker-end
+
+:::moniker range="< aspnetcore-8.0"
+
 ```csharp
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Mvc;
@@ -402,6 +457,8 @@ public class StarshipValidationController(
 }
 ```
 
+:::moniker-end
+
 Confirm or update the namespace of the preceding controller (`BlazorSample.Server.Controllers`) to match the app's controllers' namespace.
 
 When a model binding validation error occurs on the server, an [`ApiController`](xref:web-api/index) (<xref:Microsoft.AspNetCore.Mvc.ApiControllerAttribute>) normally returns a [default bad request response](xref:web-api/index#default-badrequest-response) with a <xref:Microsoft.AspNetCore.Mvc.ValidationProblemDetails>. The response contains more data than just the validation errors, as shown in the following example when all of the fields of the `Starfleet Starship Database` form aren't submitted and the form fails validation:
@@ -411,10 +468,10 @@ When a model binding validation error occurs on the server, an [`ApiController`]
   "title": "One or more validation errors occurred.",
   "status": 400,
   "errors": {
-    "Id": ["The Id field is required."],
-    "Classification": ["The Classification field is required."],
-    "IsValidatedDesign": ["This form disallows unapproved ships."],
-    "MaximumAccommodation": ["Accommodation invalid (1-100000)."]
+    "Id": [ "The Id field is required." ],
+    "Classification": [ "The Classification field is required." ],
+    "IsValidatedDesign": [ "This form disallows unapproved ships." ],
+    "MaximumAccommodation": [ "Accommodation invalid (1-100000)." ]
   }
 }
 ```
@@ -426,10 +483,10 @@ If the server API returns the preceding default JSON response, it's possible for
 
 ```json
 {
-  "Id": ["The Id field is required."],
-  "Classification": ["The Classification field is required."],
-  "IsValidatedDesign": ["This form disallows unapproved ships."],
-  "MaximumAccommodation": ["Accommodation invalid (1-100000)."]
+  "Id": [ "The Id field is required." ],
+  "Classification": [ "The Classification field is required." ],
+  "IsValidatedDesign": [ "This form disallows unapproved ships." ],
+  "MaximumAccommodation": [ "Accommodation invalid (1-100000)." ]
 }
 ```
 
@@ -951,6 +1008,50 @@ To ensure that a validation result is correctly associated with a field when usi
 
 `CustomValidator.cs`:
 
+:::moniker range=">= aspnetcore-8.0"
+
+```csharp
+using System;
+using System.ComponentModel.DataAnnotations;
+
+public class CustomValidator : ValidationAttribute
+{
+    protected override ValidationResult IsValid(object? value, 
+        ValidationContext validationContext)
+    {
+        ...
+
+        return new ValidationResult("Validation message to user.",
+            [ validationContext.MemberName! ]);
+    }
+}
+```
+
+:::moniker-end
+
+:::moniker range=">= aspnetcore-6.0 < aspnetcore-8.0"
+
+```csharp
+using System;
+using System.ComponentModel.DataAnnotations;
+
+public class CustomValidator : ValidationAttribute
+{
+    protected override ValidationResult IsValid(object? value, 
+        ValidationContext validationContext)
+    {
+        ...
+
+        return new ValidationResult("Validation message to user.",
+            new[] { validationContext.MemberName! });
+    }
+}
+```
+
+:::moniker-end
+
+:::moniker range="< aspnetcore-6.0"
+
 ```csharp
 using System;
 using System.ComponentModel.DataAnnotations;
@@ -968,6 +1069,8 @@ public class CustomValidator : ValidationAttribute
 }
 ```
 
+:::moniker-end
+
 Inject services into custom validation attributes through the <xref:System.ComponentModel.DataAnnotations.ValidationContext>. The following example demonstrates a salad chef form that validates user input with dependency injection (DI).
 
 The `SaladChef` class indicates the approved starship ingredient list for a Ten Forward salad.

aspnetcore/blazor/fundamentals/dependency-injection.md

@@ -579,7 +579,7 @@ public class CircuitServicesAccessor
     public IServiceProvider? Services
     {
         get => blazorServices.Value;
-        set => blazorServices.Value = value;
+        set => blazorServices.Value = value!;
     }
 }
 

aspnetcore/blazor/fundamentals/routing.md

@@ -199,7 +199,7 @@ In the following example, the `Routes` component is in the server project, and t
 ```razor
 <Router
     AppAssembly="..."
-    AdditionalAssemblies="new[] { typeof(BlazorSample.Client._Imports).Assembly }">
+    AdditionalAssemblies="[ typeof(BlazorSample.Client._Imports).Assembly ]">
     ...
 </Router>
 ```

aspnetcore/blazor/globalization-localization.md

@@ -1042,11 +1042,11 @@ The component adopts the following approaches to work for either SSR or CSR comp
             { "es-CR", "Spanish (Costa Rica)" }
         };
 
-    private CultureInfo[] supportedCultures = new[]
-    {
-        new CultureInfo("en-US"),
-        new CultureInfo("es-CR"),
-    };
+    private CultureInfo[] supportedCultures = 
+        [ 
+            new CultureInfo("en-US"), 
+            new CultureInfo("es-CR"),
+        ];
 
     private CultureInfo? selectedCulture;
 

aspnetcore/blazor/hybrid/class-libraries.md

@@ -186,10 +186,10 @@ namespace {APP NAMESPACE}.Services;
 
 public class WeatherForecastService : IWeatherForecastService
 {
-    private static readonly string[] Summaries = new[]
-    {
+    private static readonly string[] Summaries = 
+    [
         "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot"
-    };
+    ];
 
     public async Task<WeatherForecast[]?> GetForecastAsync(DateTime startDate) =>
         await Task.FromResult(Enumerable.Range(1, 5)

aspnetcore/blazor/javascript-interoperability/call-javascript-from-dotnet.md

@@ -1102,10 +1102,22 @@ The `{TIMEOUT}` placeholder is a <xref:System.TimeSpan> (for example, `TimeSpan.
 
 Set a per-invocation timeout in component code. The specified timeout overrides the global timeout set by <xref:Microsoft.AspNetCore.Components.Server.CircuitOptions.JSInteropDefaultCallTimeout>:
 
+:::moniker range=">= aspnetcore-8.0"
+
+```csharp
+var result = await JS.InvokeAsync<string>("{ID}", {TIMEOUT}, [ "Arg1" ]);
+```
+
+:::moniker-end
+
+:::moniker range="< aspnetcore-8.0"
+
 ```csharp
 var result = await JS.InvokeAsync<string>("{ID}", {TIMEOUT}, new[] { "Arg1" });
 ```
 
+:::moniker-end
+
 In the preceding example:
 
 * The `{TIMEOUT}` placeholder is a <xref:System.TimeSpan> (for example, `TimeSpan.FromSeconds(80)`).