<IlcArgInclude="@(RuntimeHostConfigurationOption->'--runtimeknob:%(Identity)=%(Value)')" />

<IlcArgInclude="--runtimeknob:RUNTIME_IDENTIFIER=$(RuntimeIdentifier)" />

<IlcArgCondition="$(ServerGarbageCollection) == 'true'"Include="--runtimeopt:gcServer=1" />

<IlcArgCondition="$(IlcGenerateCompleteTypeMetadata) == 'true' and $(IlcDisableReflection) != 'true'"Include="--completetypemetadata" />

<IlcArgCondition="$(IlcGenerateCompleteTypeMetadata) == 'true'"Include="--completetypemetadata" />

<IlcArgCondition="$(StackTraceSupport) != 'false'"Include="--stacktracedata" />

<IlcArgCondition="$(IlcScanReflection) != 'false' and $(IlcDisableReflection) != 'true'"Include="--scanreflection" />

<IlcArgCondition="$(IlcFoldIdenticalMethodBodies) == 'true'"Include="--methodbodyfolding" />

Reflection-free mode is a mode of the NativeAOT compiler and runtime that greatly reduces the functionality of the reflection APIs and brings a couple interesting benefits as a result. The benefits of this mode are:

Reflection-free mode is ahighly experimentalmode of the NativeAOT compiler and runtime that greatly reduces the functionality of the reflection APIs and brings a couple interesting benefits as a result. The benefits of this mode are:

* Greatly reduced size of self contained deployments - a fully self-contained "Hello world" style app compiles to a 1 MB file (on x64) with_no dependencies_.

* Reduced working set and better code locality - parts of the program are more tightly packed together.

</PropertyGroup>

(More switches are documented in the[Optimizing NativeAOT](optimizing.md) document.)

When reflection is disabled, the AOT compiler stops emitting data structures that are required to make reflection work at runtime and stops enforcing policies that makes the code more reflection friendly.

And here for CustomAttributes (will return an empty array):

<ItemGroup>

<RuntimeHostConfigurationOptionInclude="Switch.System.Reflection.Disabled.DoNotThrowForAttributes"Value="true" />

</ItemGroup>

Note:

To make``NativeLibrary`` API, and on the same occasion``Socket``, to work, you'll need:

<ItemGroup>

<RuntimeHostConfigurationOptionInclude="Switch.System.Reflection.Disabled.DoNotThrowForAssembly"Value="true" />

<RuntimeHostConfigurationOptionInclude="Switch.System.Reflection.Disabled.DoNotThrowForAttributes"Value="true" />

</ItemGroup>

The reflection-free mode is implemented as a collection of features that can be controlled individually via the AOT compiler command line options for experiments and troubleshooting, including:

-`--scanreflection` (also exposed as`IlcScanReflection` build property): Infer reflection usage by code analysis. This feature is disabled for reflection-free mode.

-`--reflectiondata:none`: Disables generation of reflection data.

-`--feature:System.Collections.Generic.DefaultComparers=false`: Disables`EqualityComparer<T>.Default` and`Comparer<T>.Default` optimizations that are based on reflection.

The complete set of individual features that the reflection-free mode is composed from currently can be found by looking for`IlcDisableReflection` in[Microsoft.NETCore.Native.targets](../BuildIntegration/Microsoft.NETCore.Native.targets).