TestCleanupAttribute 類別

識別方法，該方法所包含的程式碼必須於測試完成執行之後使用，以便釋放此測試類別中所有測試所佔用的資源。 此類別無法被繼承。

繼承階層架構

Object
  Attribute
    Microsoft.VisualStudio.TestTools.UnitTesting.TestCleanupAttribute

命名空間：  Microsoft.VisualStudio.TestTools.UnitTesting
組件：  Microsoft.VisualStudio.QualityTools.UnitTestFramework (在 Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll 中)

語法

'宣告
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class TestCleanupAttribute _
    Inherits Attribute

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

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

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

public final class TestCleanupAttribute extends Attribute

TestCleanupAttribute 類型會公開下列成員。

建構函式

	名稱	描述
	TestCleanupAttribute	初始化 TestCleanupAttribute 類別的新執行個體。

回頁首

屬性

	名稱	描述
	TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別項。 (繼承自 Attribute)。

回頁首

方法

	名稱	描述
	Equals	基礎架構。 傳回數值，表示這個執行個體是否等於指定的物件。 (繼承自 Attribute)。
	GetHashCode	傳回這個執行個體的雜湊碼。 (繼承自 Attribute)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	IsDefaultAttribute	在衍生類別中覆寫時，表示這個執行個體的值是否為衍生類別的預設值。 (繼承自 Attribute)。
	Match	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承自 Attribute)。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

明確介面實作

	名稱	描述
	System#Runtime#InteropServices#_Attribute#GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	System#Runtime#InteropServices#_Attribute#GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	System#Runtime#InteropServices#_Attribute#GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	System#Runtime#InteropServices#_Attribute#Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 Attribute)。

回頁首

備註

以這個屬性標記的方法將會在以 TestMethodAttribute 標記的方法之後，以及在以 ClassCleanupAttribute 和 AssemblyCleanupAttribute 標記的方法之前執行。

這個屬性可以在方法上加以指定。 這個屬性中只有一個執行個體可以套用至方法。

根據預設，這個屬性是在產生的程式碼中使用。

如需如何使用屬性的詳細資訊，請參閱使用屬性擴充中繼資料。

範例

SampleClassLib 命名空間包含 DivideClass 類別，這個類別則包含我們所要測試的方法。 這個方法稱為 DivideMethod()。

using System;
using System.Collections.Generic;
using System.Text;

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

Imports System
Imports System.Collections.Generic
Imports System.Text

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

在下列程式碼中，DivideClassTest 測試類別包含稱為 DivideMethodTest 的測試方法。 這個程式碼也包含控制方法、類別和組件之初始化及清除執行順序的屬性。

請特別注意 Cleanup() 方法上的 TestCleanup 屬性。

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

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

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

      [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 target = new DivideClass();
         int a = 0; 
         int actual;
         actual = target.DivideMethod(a);
      }
   }
}

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

Namespace TestNamespace

   <TestClass()> _
   Public Class DivideClassTest

      <AssemblyInitialize()> _
      Public Shared Sub AssemblyInit(ByVal context As TestContext)
         MessageBox.Show("Assembly Init")
      End Sub

      <ClassInitialize()> _
      Public Shared Sub ClassInit(ByVal context As TestContext)
         MessageBox.Show("Test Class Init")
      End Sub

      <TestInitialize()> _
      Public Sub Initialize()
         MessageBox.Show("Test Initialize")
      End Sub

      <TestCleanup()> _
      Public Sub Cleanup()
         MessageBox.Show("Test Cleanup")
      End Sub

      <ClassCleanup()> _
      Public Shared Sub ClassCleanup()
         MessageBox.Show("Test Class Cleanup")
      End Sub

      <AssemblyCleanup()> _
      Public Shared Sub AssemblyCleanup()
         MessageBox.Show("Test Assembly Cleanup")
      End Sub

      <TestMethod()> _
      <ExpectedException(GetType(System.DivideByZeroException))> _
      Public Sub DivideMethodTest()
         Dim target As SCL.DivideClass = New SCL.DivideClass
         Dim a As Integer = 0
         Dim actual As Integer
         actual = target.DivideMethod(a)
      End Sub

   End Class
End Namespace

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.TestTools.UnitTesting 命名空間