diff --git a/src/Microsoft.AspNetCore.Blazor/RenderTree/ArrayBuilder.cs b/src/Microsoft.AspNetCore.Blazor/RenderTree/ArrayBuilder.cs index 4a54e5965c..d11c136fc6 100644 --- a/src/Microsoft.AspNetCore.Blazor/RenderTree/ArrayBuilder.cs +++ b/src/Microsoft.AspNetCore.Blazor/RenderTree/ArrayBuilder.cs @@ -8,6 +8,12 @@ namespace Microsoft.AspNetCore.Blazor.RenderTree { /// /// Implements a list that uses an array of objects to store the elements. + /// + /// This differs from a in that + /// it not only grows as required but also shrinks if cleared with significant + /// excess capacity. This makes it useful for component rendering, because + /// components can be long-lived and re-render frequently, with the rendered size + /// varying dramatically depending on the user's navigation in the app. /// internal class ArrayBuilder {