Make [SupplyParameterFrom{X}] props private (#33443)

Author: guardrex

aspnetcore/blazor/advanced-scenarios.md

@@ -5,7 +5,7 @@ description: Learn how to incorporate manual logic for building Blazor render tr
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.custom: mvc
-ms.date: 02/09/2024
+ms.date: 08/26/2024
 uid: blazor/advanced-scenarios
 ---
 # ASP.NET Core Blazor advanced scenarios (render tree construction)

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

@@ -108,7 +108,7 @@ Consider the following example:
 
 @code {
     [SupplyParameterFromForm]
-    public Product? Model { get; set; }
+    private Product? Model { get; set; }
 
     protected override void OnInitialized() => Model ??= new();
 

aspnetcore/blazor/components/render-modes.md

@@ -246,7 +246,7 @@ Components use these properties to render content depending on their location or
     private bool disabled = true;
 
     [SupplyParameterFromForm]
-    public Movie? Movie { get; set; }
+    private Movie? Movie { get; set; }
 
     protected override async Task OnInitializedAsync()
     {

aspnetcore/blazor/forms/binding.md

@@ -31,7 +31,7 @@ Assignment to <xref:Microsoft.AspNetCore.Components.Forms.EditForm.Model?display
 
 @code {
     [SupplyParameterFromForm]
-    public Starship? Model { get; set; }
+    private Starship? Model { get; set; }
 
     protected override void OnInitialized() => Model ??= new();
 }
@@ -73,7 +73,7 @@ Assignment to <xref:Microsoft.AspNetCore.Components.Forms.EditForm.EditContext?d
     private EditContext? editContext;
 
     [SupplyParameterFromForm]
-    public Starship? Model { get; set; }
+    private Starship? Model { get; set; }
 
     protected override void OnInitialized()
     {
@@ -184,7 +184,7 @@ In the following example, the `HelloFormFromLibrary` component has a form named
     bool submitted = false;
 
     [SupplyParameterFromForm]
-    public string? Name { get; set; }
+    private string? Name { get; set; }
 
     private void Submit() => submitted = true;
 }
@@ -219,15 +219,15 @@ The following `NamedFormsWithScope` component uses the library's `HelloFormFromL
     bool submitted = false;
 
     [SupplyParameterFromForm]
-    public string? Name { get; set; }
+    private string? Name { get; set; }
 
     private void Submit() => submitted = true;
 }
 ```
 
 ## Supply a parameter from the form (`[SupplyParameterFromForm]`)
 
-The `[SupplyParameterFromForm]` attribute indicates that the value of the associated property should be supplied from the form data for the form. Data in the request that matches the name of the property is bound to the property. Inputs based on `InputBase<TValue>` generate form value names that match the names Blazor uses for model binding.
+The `[SupplyParameterFromForm]` attribute indicates that the value of the associated property should be supplied from the form data for the form. Data in the request that matches the name of the property is bound to the property. Inputs based on `InputBase<TValue>` generate form value names that match the names Blazor uses for model binding. Unlike component parameter properties (`[Parameter]`), properties annotated with `[SupplyParameterFromForm]` aren't required to be marked `public`.
 
 You can specify the following form binding parameters to the [`[SupplyParameterFromForm]` attribute](xref:Microsoft.AspNetCore.Components.SupplyParameterFromFormAttribute):
 

aspnetcore/blazor/forms/index.md

@@ -5,7 +5,7 @@ description: Learn how to use forms in Blazor.
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.custom: mvc
-ms.date: 02/09/2024
+ms.date: 08/26/2024
 uid: blazor/forms/index
 ---
 # ASP.NET Core Blazor forms overview

aspnetcore/blazor/forms/input-components.md

@@ -5,7 +5,7 @@ description: Learn about built-in Blazor input components.
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.custom: mvc
-ms.date: 02/09/2024
+ms.date: 08/26/2024
 uid: blazor/forms/input-components
 ---
 # ASP.NET Core Blazor input components

aspnetcore/blazor/forms/validation.md

@@ -5,7 +5,7 @@ description: Learn how to use validation in Blazor forms.
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.custom: mvc
-ms.date: 02/09/2024
+ms.date: 08/26/2024
 uid: blazor/forms/validation
 ---
 # ASP.NET Core Blazor forms validation
@@ -606,7 +606,7 @@ In the following component, update the namespace of the **`Shared`** project (`@
     private string messageStyles = "visibility:hidden";
 
     [SupplyParameterFromForm]
-    public Starship? Model { get; set; }
+    private Starship? Model { get; set; }
 
     protected override void OnInitialized() => 
         Model ??= new() { ProductionDate = DateTime.UtcNow };

aspnetcore/blazor/fundamentals/routing.md

@@ -856,15 +856,19 @@ Specify the `[SupplyParameterFromQuery]` attribute's <xref:Microsoft.AspNetCore.
 
 :::moniker range=">= aspnetcore-8.0"
 
+Unlike component parameter properties (`[Parameter]`), `[SupplyParameterFromQuery]` properties can be marked `private` in addition to `public`.
+
 ```csharp
 [SupplyParameterFromQuery(Name = "{QUERY PARAMETER NAME}")]
-public string? {COMPONENT PARAMETER NAME} { get; set; }
+private string? {COMPONENT PARAMETER NAME} { get; set; }
 ```
 
 :::moniker-end
 
 :::moniker range=">= aspnetcore-6.0 < aspnetcore-8.0"
 
+Just like component parameter properties (`[Parameter]`), `[SupplyParameterFromQuery]` properties are always `public` properties in .NET 6/7. In .NET 8 or later, `[SupplyParameterFromQuery]` properties can be marked `public` or `private`.
+
 ```csharp
 [Parameter]
 [SupplyParameterFromQuery(Name = "{QUERY PARAMETER NAME}")]
@@ -913,13 +917,13 @@ In the following example with a URL of `/search?filter=scifi%20stars&page=3&star
 
 @code {
     [SupplyParameterFromQuery]
-    public string? Filter { get; set; }
+    private string? Filter { get; set; }
 
     [SupplyParameterFromQuery]
-    public int? Page { get; set; }
+    private int? Page { get; set; }
 
     [SupplyParameterFromQuery(Name = "star")]
-    public string[]? Stars { get; set; }
+    private string[]? Stars { get; set; }
 }
 ```