Skip to content

Commit e663fdf

Browse files
authored
[Blazor] Performance - IsFixed=true for this explanation (#34292)
1 parent 45bd545 commit e663fdf

File tree

1 file changed

+2
-15
lines changed

1 file changed

+2
-15
lines changed

aspnetcore/blazor/performance.md

Lines changed: 2 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -35,23 +35,10 @@ The last two steps of the preceding sequence continue recursively down the compo
3535

3636
To prevent rendering recursion into a particular subtree, use either of the following approaches:
3737

38-
:::moniker range=">= aspnetcore-9.0"
39-
40-
* Ensure that the set parameters of child components are of primitive immutable types, such as `string`, `int`, `bool`, `DateTime`, and other similar types. The built-in logic for detecting changes automatically skips rerendering if the primitive immutable parameter values haven't changed. Only the parameters that are explicitly set on the component are considered for change detection. If you render a child component with `<Customer CustomerId="item.CustomerId" />`, where `CustomerId` is an `int` type, then the `Customer` component isn't rerendered unless `item.CustomerId` changes.
41-
* Override <xref:Microsoft.AspNetCore.Components.ComponentBase.ShouldRender%2A>:
42-
* To accept nonprimitive parameter values, such as complex custom model types or <xref:Microsoft.AspNetCore.Components.RenderFragment> values.
43-
* If authoring a UI-only component that doesn't change after the initial render, regardless of parameter value changes.
44-
45-
:::moniker-end
46-
47-
:::moniker range="< aspnetcore-9.0"
48-
49-
* Ensure that the set parameters of child components are of primitive immutable types, such as `string`, `int`, `bool`, `DateTime`, and other similar types. The built-in logic for detecting changes automatically skips rerendering if the primitive immutable parameter values haven't changed. Only the parameters that are explicitly set on the component are considered for change detection. If you render a child component with `<Customer CustomerId="item.CustomerId" />`, where `CustomerId` is an `int` type, then the `Customer` component isn't rerendered unless `item.CustomerId` changes.
38+
* Ensure that child component parameters are of primitive immutable types, such as `string`, `int`, `bool`, `DateTime`, and other similar types. The built-in logic for detecting changes automatically skips rerendering if the primitive immutable parameter values haven't changed. If you render a child component with `<Customer CustomerId="item.CustomerId" />`, where `CustomerId` is an `int` type, then the `Customer` component isn't rerendered unless `item.CustomerId` changes.
5039
* Override <xref:Microsoft.AspNetCore.Components.ComponentBase.ShouldRender%2A>:
5140
* To accept nonprimitive parameter values, such as complex custom model types, event callbacks, or <xref:Microsoft.AspNetCore.Components.RenderFragment> values.
5241
* If authoring a UI-only component that doesn't change after the initial render, regardless of parameter value changes.
53-
54-
:::moniker-end
5542

5643
The following airline flight search tool example uses private fields to track the necessary information to detect changes. The previous inbound flight identifier (`prevInboundFlightId`) and previous outbound flight identifier (`prevOutboundFlightId`) track information for the next potential component update. If either of the flight identifiers change when the component's parameters are set in [`OnParametersSet`](xref:blazor/components/lifecycle#after-parameters-are-set-onparameterssetasync), the component is rerendered because `shouldRender` is set to `true`. If `shouldRender` evaluates to `false` after checking the flight identifiers, an expensive rerender is avoided:
5744

@@ -261,7 +248,7 @@ The [`CascadingValue` component](xref:blazor/components/cascading-values-and-par
261248

262249
Setting `IsFixed` to `true` improves performance if there are a large number of other components that receive the cascaded value. Wherever possible, set `IsFixed` to `true` on cascaded values. You can set `IsFixed` to `true` when the supplied value doesn't change over time.
263250

264-
Where a component passes `this` as a cascaded value, `IsFixed` can also be set to `true`:
251+
Where a component passes `this` as a cascaded value, `IsFixed` can also be set to `true`, because `this` never changes during the component's lifecycle:
265252

266253
```razor
267254
<CascadingValue Value="this" IsFixed="true">

0 commit comments

Comments
 (0)