Configure the Linker for Blazor
By Luke Latham
Blazor is an unsupported, experimental web framework that shouldn't be used for production workloads at this time.
Blazor performs Intermediate Language (IL) linking during each Release mode build to remove unnecessary IL from the output assemblies.
You can control assembly linking with either of the following approaches:
- Disable linking globally with an MSBuild property.
- Control linking on a per-assembly basis with a configuration file.
Disable linking with an MSBuild property
Linking is enabled by default in Release mode when an app is built, which includes publishing. To disable linking for all assemblies, set the
<BlazorLinkOnBuild> MSBuild property to
false in the project file:
<PropertyGroup> <BlazorLinkOnBuild>false</BlazorLinkOnBuild> </PropertyGroup>
Control linking with a configuration file
Linking can be controlled on a per-assembly basis by providing an XML configuration file and specifying the file as an MSBuild item in the project file.
The following is an example configuration file (Linker.xml):
To learn more about the file format for the configuration file, see IL Linker: Syntax of xml descriptor.
Specify the configuration file in the project file with the
<ItemGroup> <BlazorLinkerDescriptor Include="Linker.xml" /> </ItemGroup>
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.