CA2207: Initialize value type static fields inline
Property | Value |
---|---|
Rule ID | CA2207 |
Title | Initialize value type static fields inline |
Category | Usage |
Fix is breaking or non-breaking | Non-breaking |
Enabled by default in .NET 8 | No |
Cause
A value-type declares an explicit static constructor.
Rule description
When a value-type is declared, it undergoes a default initialization where all value-type fields are set to zero and all reference-type fields are set to null
(Nothing
in Visual Basic). An explicit static constructor is only guaranteed to run before an instance constructor or static member of the type is called. Therefore, if the type is created without calling an instance constructor, the static constructor is not guaranteed to run.
If all static data is initialized inline and no explicit static constructor is declared, the C# and Visual Basic compilers add the beforefieldinit
flag to the CIL class definition. The compilers also add a private static constructor that contains the static initialization code. This private static constructor is guaranteed to run before any static fields of the type are accessed.
How to fix violations
To fix a violation of this rule initialize all static data when it is declared and remove the static constructor.
When to suppress warnings
Do not suppress a warning from this rule.