ModuleInitializerAttribute loading

[curia-damiano]

The following sentence at the end of the page is not correct:

The second new feature for code generators is module initializers. Module initializers are methods that have the ModuleInitializerAttribute attribute attached to them. These methods will be called by the runtime when the assembly loads.

I have developed a sample POC with the following code:

var assembly = Assembly.LoadFrom(@"demo.dll"); var type = assembly.GetType("SampleNamespace.SampleClass"); var constructorInfo = type.GetConstructor(new Type[] { }); _ = constructorInfo.Invoke(null);

The module initializer is NOT invoked the the assembly is loaded with Assembly.LoadFrom, but only before the last line, when I create an instance of my class.

In fact, in dotnet/runtime#35749, it is documented correctly that "This is a special static constructor that has additional runtime guarantees. It will execute before any other field access or method invocation within the entire module."

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: c36588d0-6bdf-1740-220c-10b20bb88730
• Version Independent ID: 587ed47f-f532-e018-9b0d-6ee76afd20e4
• Content: What's new in C# 9.0 - C# Guide
• Content Source: docs/csharp/whats-new/csharp-9.md
• Product: dotnet-csharp
• Technology: csharp-whats-new
• GitHub Login: @BillWagner
• Microsoft Alias: wiwagn

[BillWagner]

Thanks for writing this @curia-damiano

We'll get this updated to correctly reflect the behavior.