Initialize reference type static fields inline

转载 2006年05月26日 15:18:00
Visual Studio Team System 
Initialize reference type static fields inline 








Breaking Change



A reference type declares an explicit static constructor.

Rule Description

When a type declares an explicit static constructor, the just-in-time (JIT) compiler adds a check to each of the type's static methods and instance constructors to ensure that the static constructor was previously called. Static initialization is triggered when any static member is accessed or when an instance of the type is created. However, static initialization is not triggered if you declare a variable of the type but do not use it, which can be important if the initialization changes global state.

When all static data is initialized inline and an explicit static constructor is not declared, Microsoft intermediate language (MSIL) compilers add the beforefieldinit flag and an implicit static constructor, which initializes the static data, to the MSIL type definition. When the JIT compiler encounters the beforefieldinit flag, in most cases the static constructor checks are not added. Static initialization is guaranteed to occur at some time before any of the static fields are accessed but not before a static method or instance constructor is invoked. Note that static initialization can occur at any time after a variable of the type is declared.

Static constructor checks can reduce performance. Often a static constructor is used only to initialize static fields, in which case it is only necessary to ensure that static initialization occurs before the first access of a static field. The beforefieldinit behavior is appropriate for these and most other types. It is only inappropriate when static initialization affects global state and one of the following is true:

  • The affect on global state is expensive and is not needed if the type is not used.

  • The global state effects can be accessed without accessing any static fields of the type.

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 Exclude Warnings

It is safe to exclude a warning from this rule if performance is not a concern; or if global state changes due to static initialization are expensive, or must be guaranteed to occur before a static method of the type is called or an instance of the type is created.


The following example shows a type, StaticConstructor, that violates the rule and a type, NoStaticConstructor, that replaces the static constructor with inline initialization to satisfy the rule.

Visual Basic Copy Code
Imports System
Imports System.Resources

Namespace PerformanceLibrary

   Public Class StaticConstructor

      Shared someInteger As Integer
      Shared resourceString As String 

      Shared Sub New()

         someInteger = 3
         Dim stringManager As New ResourceManager("strings", _
         resourceString = stringManager.GetString("string")

      End Sub

   End Class

   Public Class NoStaticConstructor

      Shared someInteger As Integer = 3
      Shared resourceString As String = InitializeResourceString()

      Shared Private Function InitializeResourceString()

         Dim stringManager As New ResourceManager("strings", _
         Return stringManager.GetString("string")

      End Function

   End Class

End Namespace
using System;
using System.Reflection;
using System.Resources;

namespace PerformanceLibrary
   public class StaticConstructor
      static int someInteger;
      static string resourceString;

      static StaticConstructor()
         someInteger = 3;
         ResourceManager stringManager = 
            new ResourceManager("strings", Assembly.GetExecutingAssembly());
         resourceString = stringManager.GetString("string");

   public class NoStaticConstructor
      static int someInteger = 3;
      static string resourceString = InitializeResourceString();

      static string InitializeResourceString()
         ResourceManager stringManager = 
            new ResourceManager("strings", Assembly.GetExecutingAssembly());
         return stringManager.GetString("string");

Note the addition of the beforefieldinit flag on the MSIL definition for the NoStaticConstructor class.


.class public auto ansi StaticConstructor
       extends [mscorlib]System.Object
} // end of class StaticConstructor

.class public auto ansi beforefieldinit NoStaticConstructor
       extends [mscorlib]System.Object
} // end of class NoStaticConstructor
Related Rules


Kotlin Reference (九) Properties and Fields

most from reference声明属性Koltin的类都有属性,这些属性可以声明为可变的,使用var关键字或用val关键字生声明不可变属性。class Address { var na...

Reference Pivot Fields and Pivot Items in an Excel Pivot Table, using VBA

This section explains how to access, reference, select or use Pivot Fields and Pivot Items in a Pivo...


在《Objective C类方法load和initialize的区别》一文中,我介绍了Objective-C对待+(void)initialize和+(void)load两个方法在编译和执行时出现的不...


单例模式:懒汉式:第一次用到单例对象时,在创建(适用移动端)   饿汉式:一进入程序就创建一个单例对象:(在load方法里,alloc单例对象) 单例:1. 创建唯一的单例对象:static修饰全局变...

scripts of type [inline], operation [update] and lang [groovy] are disabled

Elasticsearch的更新文档API准许通过脚本操作来更新文档。更新操作从索引中获取文档,执行脚本,然后获得返回结果。它使用版本号来控制文档获取或者重建索引。  备注:在Elasticse...

Professional JS(三-statements&function)&(四-primitive&reference type)&黑画(5-another road)

一.Statements---flow control statements 1.if语句 ①if(condition)statement1 else statement wh...

Caused by: java.lang.AssertionError: illegal type variable reference 解决办法

07-24 10:54:13.529: E/AndroidRuntime(12130): FATAL EXCEPTION: AsyncTask #3 07-24 10:54:13.529: E/And...

关于Swift中的值类型(Value Types)与引用类型(Reference Type)

Swift里面的类型分为两种: ●值类型(Value Types):每个实例都保留了一分独有的数据拷贝。如结构体 (struct)、枚举(enum) 和元组(tuple)。 ●引用类型(Refer...

iOS: 学习笔记, 值与引用类型(译自: Aug 15, 2014 Value and Reference Type

值和引用类型 Value and Reference Types 在Swift中,有两种数据类型. 一是"值类型"(value type), 它是每一个实例都保存有各自的数据,通常定义为struct...

Passing Reference-Type Parameters (C# Programming Guide) Reference-Type Parameters (C# Progra...