AssemblyInitializeAttribute - класс

Идентифицирует метод, содержащий код для использования до запуска всех тестов в сборке и для выделения ресурсов, получаемых сборкой. Этот класс не наследуется.

Иерархия наследования

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

Пространство имен:  Microsoft.VisualStudio.TestTools.UnitTesting
Сборка:  Microsoft.VisualStudio.QualityTools.UnitTestFramework (в Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Синтаксис

'Декларация
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class AssemblyInitializeAttribute _
    Inherits Attribute

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

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

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

public final class AssemblyInitializeAttribute extends Attribute

Тип AssemblyInitializeAttribute предоставляет следующие члены.

Конструкторы

	Имя	Описание
	AssemblyInitializeAttribute	Инициализирует новый экземпляр класса AssemblyCleanupAttribute.

В начало страницы

Свойства

	Имя	Описание
	TypeId	При реализации в производном классе возвращает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute.)

В начало страницы

Методы

	Имя	Описание
	Equals	Инфраструктура. Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Возвращает хеш-код данного экземпляра. (Унаследовано от Attribute.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	IsDefaultAttribute	При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute.)
	Match	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	ToString	Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)

В начало страницы

Явные реализации интерфейса

	Имя	Описание
	_Attribute.GetIDsOfNames	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfo	Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfoCount	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute.)
	_Attribute.Invoke	Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute.)

В начало страницы

Заметки

Метод, помеченный этим атрибутом, будет выполняться до методов, помеченных атрибутами ClassInitializeAttribute, TestInitializeAttribute и TestMethodAttribute. Только один метод в сборке может быть оформлен данным атрибутом.

Важно!

Этот атрибут нельзя использовать в модульном тесте ASP.NET, т.е. в любом тесте с атрибутом [HostType("ASP.NET")].Из-за того, что в IIS и ASP.NET не учитывается состояние, метод, содержащий этот атрибут, может вызываться более одного раза при каждом тестовом запуске.

Этот атрибут можно указывать в методе. К методу можно применить только один экземпляр этого атрибута.

Примечание

Механизм тестирования выполняет метод, помеченный атрибутом AssemblyInitialize, только в том случае, если этот метод является элементом класса, помеченного атрибутом TestClass.

Дополнительные сведения об использовании атрибутов см. в разделе Расширение метаданных с помощью атрибутов.

Примеры

В следующем примере демонстрируются атрибуты инициализации и очистки, которые используются для указания того, какие методы должны выполняться средством тестирования в разные периоды теста.

Первые примеры кода содержат тестируемые класс и метод. Чтобы выполнить этот пример, создайте проект библиотеки классов и замените его код на приведенный ниже код.

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() из предыдущих примеров кода. Создайте тестовый проект и поместите в документ тестового класса следующий код. Добавьте в проект соответствующие ссылки. Этот код содержит атрибуты, управляющие порядком выполнения инициализации и очистки метода, класса и сборки.

В частности, обратите внимание на атрибут AssemblyInitialize в методе AssemblyInit().

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 (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.VisualStudio.TestTools.UnitTesting - пространство имен

Другие ресурсы

Составляющие модульного теста

Unit Testing Framework