Update complex type trimming remarks

[guardrex]

Description

To resolve #31422, language was added to two articles to cover how some complex types might be trimmed away.

In the Trimmer article ...

Trimming may have detrimental effects for the published app. In apps that use [reflection](/dotnet/csharp/advanced-topics/reflection-and-attributes/), the IL Trimmer often can't determine the required types for runtime reflection and trim them away. For example, complex framework types for JS interop, such as <xref:System.Collections.Generic.KeyValuePair>, might be trimmed by default and not available at runtime for JS interop calls. In these cases, we recommend creating your own custom types instead.

In the JS interop overview article ...

Complex framework types, such as <xref:System.Collections.Generic.KeyValuePair>, might be [trimmed away by the IL Trimmer on publish](xref:blazor/host-and-deploy/configure-trimmer) and not present for JS interop. We recommend creating custom types for types that the IL Trimmer trims away by default.

@maraf and @lewing ... Two questions ...

1. Is there a complex type that I can swap in for KeyValuePair that would still be trimmed away?

2. [release/8.0-staging][wasm] remove problematic default settings runtime#112216 is for release 8.0+, correct?

Page URL

https://learn.microsoft.com/en-us/aspnet/core/blazor/host-and-deploy/configure-trimmer?view=aspnetcore-9.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/blazor/host-and-deploy/configure-trimmer.md

Document ID

1487b5e7-a40c-d757-c530-d0e4017f189e

Article author

@guardrex

Metadata

• ID: 2203b81b-1b37-8599-eb50-f6284170d224
• Service: aspnet-core
• Sub-service: blazor

Related Issues

[github-actions]

🌱🐇 Spring is coming. Hang in there! I'm pull'in for ya! 🐣🌻

Stand-by! ... A green dinosaur 🦖 will be along shortly to assist.

[guardrex]

UPDATE (2/13/25): In spite of some framework updates for 9.0, this still repros in a published app with KeyValuePair in a 9.0 ...

Unhandled exception rendering component: ConstructorContainsNullParameterNames, System.Collections.Generic.KeyValuePair2[System.String,System.String] System.NotSupportedException: ConstructorContainsNullParameterNames, System.Collections.Generic.KeyValuePair2[System.String,System.String]

I'll enhance the current coverage per Javier's suggestion to use a custom type.

BTW ... Source gen following the guidance in https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/source-generation wasn't effective.