ClassInitializeAttribute 类

2011-08-12

标识一个包含代码的方法，这些代码必须在测试类中的任意测试运行之前使用，并用于分配测试类所使用的资源。此类不能被继承。

继承层次结构

System.Object
System.Attribute
Microsoft.VisualStudio.TestTools.UnitTesting.ClassInitializeAttribute

命名空间： Microsoft.VisualStudio.TestTools.UnitTesting
程序集： Microsoft.VisualStudio.QualityTools.UnitTestFramework（在 Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll 中）

语法

声明
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class ClassInitializeAttribute _
    Inherits Attribute

[AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false)]
public sealed class ClassInitializeAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Method, AllowMultiple = false)]
public ref class ClassInitializeAttribute sealed : public Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false)>]
type ClassInitializeAttribute =  
    class
        inherit Attribute
    end

public final class ClassInitializeAttribute extends Attribute

ClassInitializeAttribute 类型公开以下成员。

构造函数

	名称	说明
	ClassInitializeAttribute	初始化 ClassInitializeAttribute 类的新实例。

页首

属性

	名称	说明
	TypeId	当在派生类中实现时，获取该 Attribute 的唯一标识符。（继承自 Attribute。）

页首

方法

	名称	说明
	Equals	基础结构。返回一个值，该值指示此实例是否与指定的对象相等。（继承自 Attribute。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
	GetHashCode	返回此实例的哈希代码。（继承自 Attribute。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	IsDefaultAttribute	当在派生类中重写时，指示此实例的值是否是派生类的默认值。（继承自 Attribute。）
	Match	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。（继承自 Attribute。）
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

显式接口实现

	名称	说明
	_Attribute.GetIDsOfNames	将一组名称映射为对应的一组调度标识符。（继承自 Attribute。）
	_Attribute.GetTypeInfo	检索对象的类型信息，然后可以使用该信息获取接口的类型信息。（继承自 Attribute。）
	_Attribute.GetTypeInfoCount	检索对象提供的类型信息接口的数量（0 或 1）。（继承自 Attribute。）
	_Attribute.Invoke	提供对某一对象公开的属性和方法的访问。（继承自 Attribute。）

页首

备注

在负载测试中运行时，标有此属性的方法将运行一次，并且它所执行的任何初始化操作都将应用于整个测试。如果需要针对测试中的所有虚拟用户迭代仅执行一次初始化操作，请使用 TestInitializeAttribute。

方法的运行顺序如下：

用 AssemblyInitializeAttribute 标记的方法。
用 ClassInitializeAttribute 特性标记的方法。
用 TestInitializeAttribute 特性标记的方法。
用 TestMethodAttribute 特性标记的方法。

一个类中只有一个方法可以用此属性修饰。

重要事项
此属性不应当用于 ASP.NET 单元测试，即任何带有 [HostType("ASP.NET")] 属性的测试。由于 IIS 和 ASP.NET 的无状态特性，用此属性修饰的方法在每个测试运行中可以多次调用。

可以在方法上指定此属性。每个方法只能应用此特性的一个实例。

有关如何使用特性的更多信息，请参见利用特性扩展元数据。

示例

下面的示例演示初始化和清理属性，这些属性用于指示在测试的不同时期测试引擎应运行哪些方法。

第一个代码示例包含要测试的类和方法。若要运行此示例，请创建一个类库项目并将代码替换为下面的示例。

using System;

namespace SampleClassLib
{
    public class DivideClass
    {
        public static int DivideMethod(int denominator)
        {
            return (2 / denominator);
        }
    }
}

Imports System

Namespace SampleClassLib
    Public Class DivideClass
        Shared Function DivideMethod(ByVal denominator As Integer) As Integer
            Return 2 \ denominator
        End Function
    End Class
End Namespace

下面的示例包含代码，此代码用于测试在以前的代码示例中找到的 DivideMethod()。创建一个测试项目并将下面的代码放入测试类文档中。在项目中添加适当的引用。此代码包含一些属性，这些属性控制方法、类和程序集的初始化和清理的执行顺序。

请特别注意 ClassInit() 方法中的 ClassInitialize 属性。

using Microsoft.VisualStudio.TestTools.UnitTesting;
using SampleClassLib;
using System;
using System.Windows.Forms;

namespace TestNamespace
{
    [TestClass()]
    public sealed class DivideClassTest
    {
        [AssemblyInitialize()]
        public static void AssemblyInit(TestContext context)
        {
            MessageBox.Show("AssemblyInit " + context.TestName);
        }

        [ClassInitialize()]
        public static void ClassInit(TestContext context)
        {
            MessageBox.Show("ClassInit " + context.TestName);
        }

        [TestInitialize()]
        public void Initialize()
        {
            MessageBox.Show("TestMethodInit");
        }

        [TestCleanup()]
        public void Cleanup()
        {
            MessageBox.Show("TestMethodCleanup");
        }

        [ClassCleanup()]
        public static void ClassCleanup()
        {
            MessageBox.Show("ClassCleanup");
        }

        [AssemblyCleanup()]
        public static void AssemblyCleanup()
        {
            MessageBox.Show("AssemblyCleanup");
        }

        [TestMethod()]
        [ExpectedException(typeof(System.DivideByZeroException))]
        public void DivideMethodTest()
        {
            DivideClass.DivideMethod(0);
        }
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports SampleClassLib2.SampleClassLib
Imports System
Imports System.IO
Imports System.Windows.Forms

Namespace TestNamespace
    <TestClass()> _
    Public NotInheritable Class DivideClassTest
        <AssemblyInitialize()> _
        Public Shared Sub AssemblyInit(ByVal context As TestContext)
            MsgBox("AssemblyInit " + context.TestName)
        End Sub 'AssemblyInit

        <ClassInitialize()> _
        Public Shared Sub ClassInit(ByVal context As TestContext)
            MsgBox("ClassInit " + context.TestName)
        End Sub 'ClassInit

        <TestInitialize()> _
        Public Sub Initialize()
            MsgBox("TestMethodInit")
        End Sub 

        <TestCleanup()> _
        Public Sub Cleanup()
            MsgBox("TestMethodCleanup")
        End Sub 

        <ClassCleanup()> _
        Public Shared Sub ClassCleanup()
            MsgBox("ClassCleanup")
        End Sub 

        <AssemblyCleanup()> _
        Public Shared Sub AssemblyCleanup()
            MsgBox("AssemblyCleanup")
        End Sub

        <TestMethod()> _
        <ExpectedException(GetType(System.DivideByZeroException))> _
        Public Sub DivideMethodTest()
            DivideClass.DivideMethod(0)
        End Sub
    End Class
End Namespace

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared）成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.VisualStudio.TestTools.UnitTesting 命名空间

其他资源

单元测试分析

Unit Testing Framework

通过

ClassInitializeAttribute 类

继承层次结构

语法

构造函数

属性

方法

显式接口实现

备注

示例

线程安全

请参见

参考

其他资源

其他资源