ClassInitializeAttribute 類別

發行項
05/07/2013

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

繼承階層架構

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)。
	GetHashCode	傳回這個執行個體的雜湊程式碼。 (繼承自 Attribute)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	IsDefaultAttribute	在衍生類別中覆寫時，表示這個執行個體的值是否為衍生類別的預設值。 (繼承自 Attribute)。
	Match	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承自 Attribute)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

明確介面實作

	名稱	說明
	_Attribute.GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	_Attribute.GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	_Attribute.GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	_Attribute.Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 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

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.TestTools.UnitTesting 命名空間

其他資源

單元測試的結構

Unit Testing Framework

共用方式為

ClassInitializeAttribute 類別

繼承階層架構

語法

建構函式

屬性

方法

明確介面實作

備註

範例

執行緒安全

請參閱

參考

其他資源

其他資源