参照型の静的フィールドをインラインで初期化します

参照型の静的フィールドをインラインで初期化します

低帯域幅での表示をオンにする

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2008/.NET Framework 3.5

その他のバージョンについては、以下の情報を参照してください。

Visual Studio Team System

参照型の静的フィールドをインラインで初期化します

更新 : 2007 年 11 月

TypeName	InitializeReferenceTypeStaticFieldsInline
CheckId	CA1810
カテゴリ	Microsoft.Performance
互換性に影響する変更点	なし

原因

参照型で明示的な静的コンストラクタを宣言しています。

規則の説明

型で明示的な静的コンストラクタを宣言すると、Just-In-Time (JIT) コンパイラは、静的コンストラクタが呼び出されたことを確認するために、型の静的メソッドと静的インスタンスコンストラクタのそれぞれにチェックを追加します。任意の静的メンバがアクセスされたとき、または型のインスタンスが作成されたときに、静的な初期化が発生します。ただし、可変の型を宣言していて使用しないと、静的な初期化は発生しません。初期化によってグローバルな状態が変化する場合、これは重要な問題になることがあります。

静的データがすべてインラインで初期化され、明示的な静的コンストラクタが宣言されていない場合、Microsoft Intermediate Language (MSIL) コンパイラは、beforefieldinit フラグと暗黙的な静的コンストラクタを追加します。これによって静的データは MSIL の型定義に初期化されます。JIT コンパイラで beforefieldinit フラグが検出されると、ほとんどの場合、静的コンストラクタのチェックは追加されません。静的な初期化は、静的フィールドのいずれかにアクセスされる前で、静的メソッドまたは静的インスタンスコンストラクタが呼び出される前のある時点で発生することが保証されています。静的な初期化は、可変の型が宣言された後であればいつでも発生する可能性があることに注意してください。

静的コンストラクタのチェックによってパフォーマンスが低下することがあります。多くの場合、静的コンストラクタは、静的フィールドを初期化するためにのみ使用されます。このとき必要なのは、静的な初期化が静的フィールドへ最初にアクセスされる前に発生することのみです。このような場合、および他のほとんどの型の場合、beforefieldinit の動作は適切です。静的な初期化によってグローバル状態に影響を及ぼし、さらに次のいずれかの条件に該当する場合は、不適切になります。

グローバル状態に及ぼす影響のコストが高く、型を使用しなければ必要がない場合。
型の静的フィールドにアクセスしなくても、グローバル状態の結果にアクセスできる場合。

違反の修正方法

この規則違反を修正するには、静的データが宣言されたとき、および静的コンストラクタを削除するときに、静的データをすべて初期化します。

警告を抑制する状況

この規則による警告を抑制しても安全なのは、パフォーマンスが重要視されていない場合、静的な初期化によるグローバル状態の変化のコストが高い場合、またはその型の静的メソッドが呼び出されるかその型のインスタンスが作成される前にグローバル状態の変化が発生すると保証されている場合のいずれかです。

使用例

この規則に違反する型 StaticConstructor と、規則に適合するように静的コンストラクタをインラインの初期化で置換した型 NoStaticConstructor を次の例に示します。

Visual Basic

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", _
            System.Reflection.Assembly.GetExecutingAssembly())
         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", _
            System.Reflection.Assembly.GetExecutingAssembly())
         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");
      }
   }
}

NoStaticConstructor クラスの MSIL 定義に beforefieldinit フラグを追加していることに注意してください。

.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