AssemblyInitializeAttribute 类
更新:2007 年 11 月
标识一个包含代码的方法,该代码在运行程序集中的所有测试之前使用并分配程序集获得的资源。此类不能被继承。
命名空间: Microsoft.VisualStudio.TestTools.UnitTesting
程序集: Microsoft.VisualStudio.QualityTools.UnitTestFramework(在 Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll 中)
语法
声明
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class AssemblyInitializeAttribute _
Inherits Attribute
用法
Dim instance As AssemblyInitializeAttribute
[AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false)]
public sealed class AssemblyInitializeAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Method, AllowMultiple = false)]
public ref class AssemblyInitializeAttribute sealed : public Attribute
public final class AssemblyInitializeAttribute extends Attribute
备注
将在用 ClassInitializeAttribute、TestInitializeAttribute 和 TestMethodAttribute 属性标记的方法之前运行用该属性标记的方法。一个程序集中只有一个方法可用该属性修饰。
重要说明: |
---|
此属性不应当用于 ASP.NET 单元测试,即任何带有 [HostType("ASP.NET")] 属性的测试。由于 IIS 和 ASP.NET 的无状态特性,用此属性修饰的方法在每个测试运行中可以多次调用。 |
可以在方法上指定此属性。每个方法只能应用此属性的一个实例。
说明: |
---|
对于带有 AssemblyInitialize 属性标记的方法,仅当该方法属于带有 TestClass 属性标记的类的成员时,测试引擎才会运行它。 |
有关如何使用属性的更多信息,请参见 利用属性扩展元数据。
示例
下面的示例演示初始化和清理属性,这些属性用于指示在测试的不同时期测试引擎应运行哪些方法。
第一个代码示例包含要测试的类和方法。若要运行此示例,请创建一个类库项目并将代码替换为下面的示例。
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()。创建一个测试项目并将下面的代码放入测试类文档中。在项目中添加适当的引用。此代码包含一些属性,这些属性控制方法、类和程序集的初始化和清理的执行顺序。
请特别注意 AssemblyInit() 方法上的 AssemblyInitialize 属性。
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
继承层次结构
System.Object
System.Attribute
Microsoft.VisualStudio.TestTools.UnitTesting.AssemblyInitializeAttribute
线程安全
此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
另请参见
参考
AssemblyInitializeAttribute 成员
Microsoft.VisualStudio.TestTools.UnitTesting 命名空间