TypeInitializationException 类

定义

命名空间:: System

程序集:: mscorlib.dll, System.Runtime.dll

程序集:: netstandard.dll, System.Runtime.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

Source:: TypeInitializationException.cs

Source:: TypeInitializationException.cs

Source:: TypeInitializationException.cs

Source:: TypeInitializationException.cs

Source:: TypeInitializationException.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

作为类初始值设定项引发的异常的包装器引发的异常。此类不能被继承。

public ref class TypeInitializationException sealed : Exception

public ref class TypeInitializationException sealed : SystemException

public sealed class TypeInitializationException : Exception

public sealed class TypeInitializationException : SystemException

[System.Serializable]
public sealed class TypeInitializationException : SystemException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class TypeInitializationException : SystemException

type TypeInitializationException = class
    inherit Exception

type TypeInitializationException = class
    inherit SystemException

[<System.Serializable>]
type TypeInitializationException = class
    inherit SystemException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TypeInitializationException = class
    inherit SystemException

Public NotInheritable Class TypeInitializationException
Inherits Exception

Public NotInheritable Class TypeInitializationException
Inherits SystemException

继承: Object

Exception
TypeInitializationException

继承: Object

Exception

SystemException
TypeInitializationException

属性: SerializableAttribute ComVisibleAttribute

注解

当类初始值设定项无法初始化类型时，将创建 a TypeInitializationException 并传递对该类型的类初始值设定项引发的异常的引用。 InnerException的 TypeInitializationException 属性保存着基础异常。

通常， TypeInitializationException 异常反映灾难性条件（运行时无法实例化类型），以防止应用程序继续。通常情况下，TypeInitializationException 是在应用程序执行环境发生某些变化时引发的。因此，除了可能用于对调试代码进行故障排除之外，不应在块中 try/catch 处理异常。相反，应调查并消除异常的原因。

TypeInitializationException 使用具有值0x80131534的 HRESULT COR_E_TYPEINITIALIZATION。

有关实例 TypeInitializationException的初始属性值列表，请参阅 TypeInitializationException 构造函数。

以下部分介绍引发 TypeInitializationException 异常的一些情况。

静态构造函数

静态构造函数（如果存在）在创建类型的新实例之前由运行时自动调用。静态构造函数可由开发人员显式定义。如果未显式定义静态构造函数，编译器会自动创建一个来初始化类型的任何 static （在 C# 或 F# 中）或 Shared （在 Visual Basic 中）成员。有关静态构造函数的详细信息，请参阅静态构造函数。

通常， TypeInitializationException 当静态构造函数无法实例化类型时，将引发异常。该 InnerException 属性指示静态构造函数无法实例化类型的原因。 TypeInitializationException 异常的一些更常见的原因包括：

静态构造函数中的未经处理的异常

如果在静态构造函数中引发异常，该异常将会被包装在TypeInitializationException异常中，并且无法实例化该类型。

通常使此异常难以进行故障排除的是，静态构造函数并不总是在源代码中显式定义。在某个类型中存在静态构造函数的条件是：

它已显式定义为类型的成员。
该类型具有 static （在 C# 或 F# 中）或 Shared （在 Visual Basic 中）变量，这些变量在单个语句中声明和初始化。在这种情况下，语言编译器为类型生成静态构造函数。例如，当 C# 和 VB 编译器编译以下示例时，它们将为类似于下面的静态构造函数生成 IL：
```
.method private specialname rtspecialname static
        void  .cctor() cil managed
{
  // Code size       12 (0xc)
  .maxstack  8
  IL_0000:  ldc.i4.3
  IL_0001:  newobj     instance void TestClass::.ctor(int32)
  IL_0006:  stsfld     class TestClass Example::test
  IL_000b:  ret
} // end of method Example::.cctor
```

以下示例演示 TypeInitializationException 编译器生成的静态构造函数引发的异常。该 Example 类包含一个字段：在 C# 中是 static，在 Visual Basic 中是 Shared，其字段类型为 TestClass，并通过向类构造函数传递值 3 来实例化。然而，该值是非法的;仅允许 0 或 1 的值。因此，TestClass类构造函数将抛出ArgumentOutOfRangeException。由于此异常未被处理，因此它被包装在一个 TypeInitializationException 异常中。

using System;

public class Example
{
   private static TestClass test = new TestClass(3);
   
   public static void Main()
   {
      Example ex = new Example();
      Console.WriteLine(test.Value);
   }
}

public class TestClass
{
   public readonly int Value;
   
   public TestClass(int value)
   {
      if (value < 0 || value > 1) throw new ArgumentOutOfRangeException(nameof(value));
      Value = value;
   }
}
// The example displays the following output:
//    Unhandled Exception: System.TypeInitializationException: 
//       The type initializer for 'Example' threw an exception. ---> 
//       System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values.
//       at TestClass..ctor(Int32 value)
//       at Example..cctor()
//       --- End of inner exception stack trace ---
//       at Example.Main()

Public Class Example1
    Shared test As New TestClass(3)

    Public Shared Sub Main()
        Dim ex As New Example1()
        Console.WriteLine(test.Value)
    End Sub
End Class

Public Class TestClass
   Public ReadOnly Value As Integer

   Public Sub New(value As Integer)
        If value < 0 Or value > 1 Then
            Throw New ArgumentOutOfRangeException(NameOf(value))
        End If
        Value = value
   End Sub
End Class

' The example displays the following output:
'    Unhandled Exception: System.TypeInitializationException:
'       The type initializer for 'Example' threw an exception. --->
'       System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values.
'       at TestClass..ctor(Int32 value)
'       at Example..cctor()
'       --- End of inner exception stack trace ---
'       at Example.Main()

异常消息显示有关 InnerException 属性的信息。

缺少程序集或数据文件

TypeInitializationException 异常的常见原因是应用程序开发和测试环境中存在的程序集或数据文件在其运行时环境中缺失。例如，可以使用以下命令行语法将以下示例编译为名为 Missing1a.dll 的程序集：

csc -t:library Missing1a.cs

fsc --target:library Missing1a.fs

vbc Missing1a.vb -t:library

using System;

public class InfoModule
{
   private DateTime firstUse;
   private int ctr = 0;

   public InfoModule(DateTime dat)
   {
      firstUse = dat;
   }
   
   public int Increment()
   {
      return ++ctr;
   }
   
   public DateTime GetInitializationTime()
   {
      return firstUse;
   }
}

open System

type InfoModule(firstUse: DateTime) =
    let mutable ctr = 0

    member _.Increment() =
        ctr <- ctr + 1
        ctr
   
    member _.GetInitializationTime() =
        firstUse

Public Class InfoModule
   Private firstUse As DateTime
   Private ctr As Integer = 0

   Public Sub New(dat As DateTime)
      firstUse = dat
   End Sub
   
   Public Function Increment() As Integer
      ctr += 1
      Return ctr
   End Function
   
   Public Function GetInitializationTime() As DateTime
      Return firstUse
   End Function
End Class

然后，可以通过包括对 Missing1a.dll的引用，将以下示例编译为名为 Missing1.exe 的可执行文件：

csc Missing1.cs /r:Missing1a.dll

vbc Missing1.vb /r:Missing1a.dll

但是，如果重命名、移动或删除 Missing1a.dll 并运行该示例，则会引发异常 TypeInitializationException 并显示示例中所示的输出。请注意，异常消息包含有关 InnerException 该属性的信息。在这种情况下，内部异常是运行时找不到依赖程序集而引发的 FileNotFoundException。

using System;

public class MissingEx1
{
    public static void Main()
    {
        Person p = new Person("John", "Doe");
        Console.WriteLine(p);
    }
}

public class Person
{
    static readonly InfoModule s_infoModule;

    readonly string _fName;
    readonly string _lName;

    static Person()
    {
        s_infoModule = new InfoModule(DateTime.UtcNow);
    }

    public Person(string fName, string lName)
    {
        _fName = fName;
        _lName = lName;
        s_infoModule.Increment();
    }

    public override string ToString()
    {
        return string.Format("{0} {1}", _fName, _lName);
    }
}
// The example displays the following output if missing1a.dll is renamed or removed:
//    Unhandled Exception: System.TypeInitializationException: 
//       The type initializer for 'Person' threw an exception. ---> 
//       System.IO.FileNotFoundException: Could not load file or assembly 
//       'Missing1a, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null' 
//       or one of its dependencies. The system cannot find the file specified.
//       at Person..cctor()
//       --- End of inner exception stack trace ---
//       at Person..ctor(String fName, String lName)
//       at Example.Main()

open System

type Person(fName, lName) =
    static let infoModule = InfoModule DateTime.UtcNow
    
    do infoModule.Increment() |> ignore
   
    override _.ToString() =
        $"{fName} {lName}"
let p = Person("John", "Doe")

printfn $"{p}"
// The example displays the following output if missing1a.dll is renamed or removed:
//    Unhandled Exception: System.TypeInitializationException: 
//       The type initializer for 'Person' threw an exception. ---> 
//       System.IO.FileNotFoundException: Could not load file or assembly 
//       'Missing1a, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null' 
//       or one of its dependencies. The system cannot find the file specified.
//       at Person..cctor()
//       --- End of inner exception stack trace ---
//       at Person..ctor(String fName, String lName)
//       at Example.Main()

Module Example3
    Public Sub Main()
        Dim p As New Person("John", "Doe")
        Console.WriteLine(p)
    End Sub
End Module

Public Class Person
   Shared infoModule As InfoModule
   
   Dim fName As String
   Dim mName As String
   Dim lName As String
   
   Shared Sub New()
      infoModule = New InfoModule(DateTime.UtcNow)
   End Sub
   
   Public Sub New(fName As String, lName As String)
      Me.fName = fName
      Me.lName = lName
      infoModule.Increment()
   End Sub
   
   Public Overrides Function ToString() As String
      Return String.Format("{0} {1}", fName, lName)
   End Function
End Class
' The example displays the following output if missing1a.dll is renamed or removed:
'    Unhandled Exception: System.TypeInitializationException: 
'       The type initializer for 'Person' threw an exception. ---> 
'       System.IO.FileNotFoundException: Could not load file or assembly 
'       'Missing1a, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null' 
'       or one of its dependencies. The system cannot find the file specified.
'       at Person..cctor()
'       --- End of inner exception stack trace ---
'       at Person..ctor(String fName, String lName)
'       at Example.Main()

注释

在此示例中， TypeInitializationException 由于无法加载程序集，因此引发了异常。如果静态构造函数尝试打开数据文件（例如配置文件、XML 文件或包含序列化数据的文件）但无法找到，则也可能引发异常。

正则表达式匹配超时值

可以为每个应用程序域设置正则表达式模式匹配操作的默认超时值。超时是通过为 TimeSpan 方法指定“REGEX_DEFAULT_MATCH_TIMEOUT”属性的 AppDomain.SetData 值来定义的。时间间隔必须是大于零且小于大约 24 天的有效 TimeSpan 对象。如果未满足这些要求，则尝试设置默认超时值会引发一个ArgumentOutOfRangeException异常，该异常又会被包装在一个TypeInitializationException异常中。

以下示例显示分配给“REGEX_DEFAULT_MATCH_TIMEOUT”属性的值无效时引发的 TypeInitializationException 值。若要消除异常，请将“REGEX_DEFAULT_MATCH_TIMEOUT”属性设置为 TimeSpan 大于零且小于大约 24 天的值。

using System;
using System.Text.RegularExpressions;
using static System.Net.Mime.MediaTypeNames;

public class RegexEx1
{
    public static void Run()
    {
        AppDomain domain = AppDomain.CurrentDomain;
        // Set a timeout interval of -2 seconds.
        domain.SetData("REGEX_DEFAULT_MATCH_TIMEOUT", TimeSpan.FromSeconds(-2));

        Regex rgx = new Regex("[aeiouy]");
        Console.WriteLine($"Regular expression pattern: {rgx.ToString()}");
        Console.WriteLine($"Timeout interval for this regex: {rgx.MatchTimeout.TotalSeconds} seconds");
    }
}

// The example displays the following output:

//    Unhandled exception. System.TypeInitializationException:
//       The type initializer for 'System.Text.RegularExpressions.Regex' threw an exception. --->
//       System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values.
//       (Parameter 'AppDomain data 'REGEX_DEFAULT_MATCH_TIMEOUT' contains the invalid value or object
//       '-00:00:02' for specifying a default matching timeout for System.Text.RegularExpressions.Regex.')
//       at System.Text.RegularExpressions.Regex.InitDefaultMatchTimeout()
//       at System.Text.RegularExpressions.Regex..cctor()
//       --- End of inner exception stack trace ---
//       at System.Text.RegularExpressions.Regex..ctor(String pattern, CultureInfo culture)
//       at RegexEx1.Run()

open System
open System.Text.RegularExpressions

let domain = AppDomain.CurrentDomain
// Set a timeout interval of -2 seconds.
domain.SetData("REGEX_DEFAULT_MATCH_TIMEOUT", TimeSpan.FromSeconds -2)

let rgx = Regex "[aeiouy]"
printfn $"Regular expression pattern: {rgx}"
printfn $"Timeout interval for this regex: {rgx.MatchTimeout.TotalSeconds} seconds"
// The example displays the following output:
//    Unhandled Exception: System.TypeInitializationException: 
//       The type initializer for 'System.Text.RegularExpressions.Regex' threw an exception. ---> 
//       System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values.
//       Parameter name: AppDomain data 'REGEX_DEFAULT_MATCH_TIMEOUT' contains an invalid value or 
//       object for specifying a default matching timeout for System.Text.RegularExpressions.Regex.
//       at System.Text.RegularExpressions.Regex.InitDefaultMatchTimeout()
//       at System.Text.RegularExpressions.Regex..cctor()
//       --- End of inner exception stack trace ---
//       at System.Text.RegularExpressions.Regex..ctor(String pattern)
//       at Example.Main()

Imports System.Text.RegularExpressions

Module Example4
    Public Sub Main()
        Dim domain As AppDomain = AppDomain.CurrentDomain
        ' Set a timeout interval of -2 seconds.
        domain.SetData("REGEX_DEFAULT_MATCH_TIMEOUT", TimeSpan.FromSeconds(-2))

        Dim rgx As New Regex("[aeiouy]")
        Console.WriteLine("Regular expression pattern: {0}", rgx.ToString())
        Console.WriteLine("Timeout interval for this regex: {0} seconds",
                        rgx.MatchTimeout.TotalSeconds)
    End Sub
End Module
' The example displays the following output:
'    Unhandled Exception: System.TypeInitializationException: 
'       The type initializer for 'System.Text.RegularExpressions.Regex' threw an exception. ---> 
'       System.ArgumentOutOfRangeException: Specified argument was out of the range of valid values.
'       Parameter name: AppDomain data 'REGEX_DEFAULT_MATCH_TIMEOUT' contains an invalid value or 
'       object for specifying a default matching timeout for System.Text.RegularExpressions.Regex.
'       at System.Text.RegularExpressions.Regex.InitDefaultMatchTimeout()
'       at System.Text.RegularExpressions.Regex..cctor()
'       --- End of inner exception stack trace ---
'       at System.Text.RegularExpressions.Regex..ctor(String pattern)
'       at Example.Main()

日历和文化数据

如果尝试实例化日历，但运行时无法实例化 CultureInfo 对应于该日历的对象，则会引发异常 TypeInitializationException 。以下日历类构造函数可以引发此异常：

JapaneseCalendar 类的无参数构造函数。
KoreanCalendar 类的无参数构造函数。
TaiwanCalendar 类的无参数构造函数。

由于这些区域性的文化数据应该在所有系统上都可用，因此很少遇到此异常（如果有的话）。

构造函数

名称	说明
TypeInitializationException(String, Exception)	使用默认错误消息、指定的类型名称和对此异常的根本原因的内部异常的引用初始化类的新实例 TypeInitializationException 。

属性

名称	说明
Data	获取键/值对的集合，这些键/值对提供有关异常的其他用户定义的信息。 (继承自 Exception)
HelpLink	获取或设置与此异常关联的帮助文件的链接。 (继承自 Exception)
HResult	获取或设置 HRESULT，它是分配给特定异常的编码数值。 (继承自 Exception)
InnerException	Exception获取导致当前异常的实例。 (继承自 Exception)
Message	获取描述当前异常的消息。 (继承自 Exception)
Source	获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception)
StackTrace	获取调用堆栈上即时帧的字符串表示形式。 (继承自 Exception)
TargetSite	获取引发当前异常的方法。 (继承自 Exception)
TypeName	获取无法初始化的类型的完全限定名称。

方法

名称	说明
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetBaseException()	在派生类中重写时，返回 Exception 一个或多个后续异常的根本原因。 (继承自 Exception)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	已过时. SerializationInfo使用类型名称和其他异常信息设置对象。
GetType()	获取当前实例的运行时类型。 (继承自 Exception)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
ToString()	创建并返回当前异常的字符串表示形式。 (继承自 Exception)

活动

名称	说明
SerializeObjectState	已过时. 序列化异常以创建包含有关异常的序列化数据的异常状态对象时发生。 (继承自 Exception)

适用于

另请参阅

反馈

此页面是否有帮助？