ClassInitializeAttribute-Klasse

Artikel
08/23/2008

Aktualisiert: November 2007

Gibt eine Methode mit darin enthaltenem Code an, der vor dem Ausführen von Tests in der Testklasse verwendet werden muss und der Testklasse die zu verwendenden Ressourcen zuordnet. Diese Klasse kann nicht geerbt werden.

Namespace: Microsoft.VisualStudio.TestTools.UnitTesting
Assembly: Microsoft.VisualStudio.SmartDevice.UnitTestFramework (in Microsoft.VisualStudio.SmartDevice.UnitTestFramework.dll)

Syntax

<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

Hinweise

Die mit diesem Attribut markierte Methode wird in einem Auslastungstest einmal ausgeführt. Alle von der Methode ausgeführten Initialisierungsvorgänge gelten für den gesamten Test. Wenn im Test Initialisierungsvorgänge für jede Iteration der virtuellen Benutzer ausgeführt werden müssen, verwenden Sie TestInitializeAttribute.

Die Methoden werden in folgender Reihenfolge ausgeführt:

Mit AssemblyInitializeAttribute markierte Methoden.
Mit ClassInitializeAttribute markierte Methoden.
Mit TestInitializeAttribute markierte Methoden.
Mit TestMethodAttribute markierte Methoden.

In einer Klasse kann nur eine Methode mit diesem Attribut versehen werden.

Wichtiger Hinweis:
Dieses Attribut sollte nicht für ASP.NET-Komponententests verwendet werden, d. h., Tests mit [HostType("ASP.NET")]-Attribut. Da IIS und ASP.NET zustandsfrei sind, kann eine mit diesem Attribut ausgestattete Methode in einem Testlauf mehrmals aufgerufen werden.

Dieses Attribut kann für eine Methode angegeben werden. Auf eine Methode kann nur eine Instanz dieses Attributs angewendet werden.

Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Beispiele

In den folgenden Beispielen werden die Initialisierungs- und Bereinigungsattribute dargestellt, durch welche die Methoden angegeben werden, die vom Testmodul während verschiedener Testphasen ausgeführt werden sollen.

Die ersten Codebeispiele enthalten eine Klasse und eine Methode, die getestet werden sollen. Um dieses Beispiel auszuführen, erstellen Sie ein Klassenbibliotheksprojekt und ersetzen den Code durch folgendes Beispiel.

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

Das folgende Beispiel enthält Code, mit dem DivideMethod() aus den vorherigen Codebeispielen getestet wird. Erstellen Sie ein Testprojekt, und fügen Sie den folgenden Code in ein Testklassendokument ein. Fügen Sie dem Projekt die entsprechenden Verweise hinzu. Dieser Code enthält Attribute, die für die Methode, Klasse und Assembly die Reihenfolge der Ausführung von Initialisierungen und Bereinigungen steuern.

Beachten Sie insbesondere das ClassInitialize-Attribut der ClassInit()-Methode.

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

Vererbungshierarchie

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.