ClassInitializeAttribute 類別

發行項
08/21/2008

更新：2007 年 11 月

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

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

語法

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

Dim instance As ClassInitializeAttribute

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

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

public final class ClassInitializeAttribute extends Attribute

備註

在負載測試中執行時，以這個屬性 (Attribute) 標記的方法會執行一次，而且它所執行的任何初始化作業都會套用至整個測試。如果您必須針對測試中的每個虛擬使用者反覆項目執行一次初始化作業，請使用 TestInitializeAttribute。

執行方法的順序為：

以 AssemblyInitializeAttribute 標記的方法。
以 ClassInitializeAttribute 標記的方法。
以 TestInitializeAttribute 標記的方法。
以 TestMethodAttribute 標記的方法。

每個類別中只能有一個方法以這個屬性裝飾。

重要事項：
這個屬性不應該在 ASP.NET 單元測試中使用，也就是具有 [HostType("ASP.NET")] 屬性的任何測試。由於 IIS 和 ASP.NET 的沒有狀態 (Stateless) 本質的緣故，所以在每一次的測試執行中，以這個屬性裝飾的方法可能會呼叫一次以上。

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

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

範例

下列範例將示範初始化和清除屬性，這些屬性是用來表示在測試的不同時期，測試引擎應該執行哪些方法。

第一組程式碼範例包含要測試的類別和方法。若要執行此範例，請建立一個類別庫專案，並以下列範例取代其程式碼。

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