AssemblyCleanupAttribute 类

项目
05/20/2013

标识一个包含代码的方法，该代码在运行程序集中的所有测试之后使用并释放程序集获得的资源。此类不能被继承。

继承层次结构

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

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

语法

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

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

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

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

public final class AssemblyCleanupAttribute extends Attribute

AssemblyCleanupAttribute 类型公开以下成员。

构造函数

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

页首

属性

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

页首

方法

	名称	说明
	Equals	基础结构。返回一个值，该值指示此实例是否与指定的对象相等。（继承自 Attribute。）
	GetHashCode	返回此实例的哈希代码。（继承自 Attribute。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	IsDefaultAttribute	当在派生类中重写时，指示此实例的值是否是派生类的默认值。（继承自 Attribute。）
	Match	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。（继承自 Attribute。）
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

显式接口实现

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

页首

备注

将在用 TestCleanupAttribute 和 ClassCleanupAttribute 属性标记的方法之后运行用该属性标记的方法。如果引发未经处理的异常，则不执行该方法。如果具有 AssemblyCleanupAttribute 特性的方法与测试方法所在的类不同，将执行该方法。一个程序集中只有一个方法可用该属性修饰。

重要事项
此属性不应当用于 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()。创建一个测试项目并将下面的代码放入测试类文档中。在项目中添加适当的引用。此代码包含一些属性，这些属性控制方法、类和程序集的初始化和清理的执行顺序。

请特别注意 AssemblyCleanup() 方法上的 AssemblyCleanup 属性。

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

通过

AssemblyCleanupAttribute 类

继承层次结构

语法

构造函数

属性

方法

显式接口实现

备注

示例

线程安全

请参见

参考

其他资源

其他资源