Is the order of static class initialization in C# deterministic?
Straight from ECMA-334:
17.4.5.1: "If a static constructor (§17.11) exists in the class, execution of the static field initializers occurs immediately prior to executing that static constructor. Otherwise, the static field initializers are executed at an implementation-dependent time prior to the first use of a static field of that class."
And:
17.11: The execution of a static constructor is triggered by the first of the following events to occur within an application domain:
- An instance of the class is created.
- Any of the static members of the class are referenced.
If a class contains the Main method (§10.1) in which execution begins, the static constructor for that class executes before the Main method is called. If a class contains any static fields with initializers, those initializers are executed in textual order immediately prior to executing the static constructor (§17.4.5).
So the order is:
A.X
used, sostatic A()
called.A.X
needs to be initialized, but it usesB.X
, sostatic B()
called.B.X
needs to be initialized, and it is initialized to 7.B.X = 7
- All static fields of
B
are initialized, sostatic B()
is called.X
is printed ("7"), then it is set toA.X
.A
has already started being initialized, so we get the value ofA.X
, which is the default value ("when a class is initialized, all static fields in that class are first initialized to their default value");B.X = 0
, and is printed ("0"). - Done initializing
B
, and the value ofA.X
is set toB.X+1
.A.X = 1
. - All static fields of
A
are initialized, sostatic A()
is called.A.X
is printed ("1"). - Back in
Main
, the values ofA.X
andB.X
are printed ("1", "0").
It actually comments upon this in the standard:
17.4.5: It is possible for static fields with variable initializers to be observed in their default value state. However, this is strongly discouraged as a matter of style.
About four different rules in the C# spec are involved in making this guarantee, and it is specific to C#. The only guarantee made by the .NET runtime is that type initialization begins before the type is used.
- That static fields are zero-initialized until the type initializer runs.
- That static field initializers run immediately before the static constructor.
- That static constructors are called at the first instance constructor call or first static member reference.
- That function arguments are evaluated in left-to-right order.
Relying on this is a very bad idea because it is likely to confuse anyone reading your code, especially if they are familiar with languages with a similar syntax which do not make all four of the above guarantees.
Please note that Porges comment was related to my initial statement (based on the .NET behavior) that the guarantees are too weak to assure the observed behavior. Porges is right that the guarantees are strong enough, but in fact a far more complex chain is involved than he suggests.
You may be interested to know that it's even possible to assign values to a field between its default initialization and variable initialization.
private static int b = Foo();
private static int a = 4;
private static int Foo()
{
Console.WriteLine("{0} - Default initialization", a);
a = 3;
Console.WriteLine("{0} - Assignment", a);
return 0;
}
public static void Main()
{
Console.WriteLine("{0} - Variable initialization", a);
}
outputs
0 - Default initialization
3 - Assignment
4 - Variable initialization