ExpectedExceptionAttribute - класс

Статья
11/05/2008

Обновлен: Ноябрь 2007

Указывает, что во время выполнения метода теста ожидается исключение. Этот класс не наследуется.

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

Синтаксис

'Декларация
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False)> _
Public NotInheritable Class ExpectedExceptionAttribute _
    Inherits Attribute
'Применение
Dim instance As ExpectedExceptionAttribute

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

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

public final class ExpectedExceptionAttribute extends Attribute

Заметки

Данный атрибут используется для проверки, возникло ли ожидаемое исключение. Метод теста пройдет, если ожидаемое исключение возникло. Метод теста завершится с ошибкой, возникшее исключение наследуется из ожидаемого исключения.

Если тест имеет как атрибут ExpectedException, так и оператор Assert, любой из них может привести к завершению теста с ошибкой. Чтобы определить, атрибут или оператор привел к завершению теста с ошибкой, откройте для теста страницу "Подробные сведения", дважды щелкнув на результате теста. Дополнительные сведения о результатах теста см. в разделе Получение результатов теста.

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

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

Примеры

Следующий класс содержит тестируемый метод.

using System;

namespace MyCSNamespace
{
    public class DivisionClass
    {
        public int Divide(int numerator, int denominator)
        {
            return numerator / denominator;
        }
    }
}

Public Class DivisionClass
   Public Function Divide(ByVal numerator As Integer, ByVal denominator As Integer) As Integer
      Return numerator \ denominator
   End Function
End Class

В следующем методе теста тестируется метод Divide объекта DivisionClass. Выполняется проверка существования DivideByZeroException.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using MyCSNamespace;

namespace MyCSTestProject
{
    [TestClass()]
    public class DivisionClassTest
    {
        [TestMethod()]
        [ExpectedException(typeof(System.DivideByZeroException))]
        public void DivideTest()
        {
            DivisionClass target = new DivisionClass();
            int numerator = 4;
            int denominator = 0;
            int actual;
            actual = target.Divide(numerator, denominator);
        }
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports MyVBProject

<TestClass()> _
Public Class DivisionClassTest
    <TestMethod()> _
    <ExpectedException(GetType(System.DivideByZeroException), "MyMessage")> _
    Public Sub DivideTest()
        Dim target As DivisionClass = New DivisionClass
        Dim numerator As Integer = 4
        Dim denominator As Integer = 0
        Dim actual As Integer
        actual = target.Divide(numerator, denominator)
    End Sub
End Class

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

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

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

ExpectedExceptionAttribute - члены

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

Поделиться через