ExpectedExceptionAttribute 클래스

업데이트: 2007년 11월

테스트 메서드를 실행하는 동안 예외가 발생해야 함을 나타냅니다. 이 클래스는 상속될 수 없습니다.

네임스페이스:  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

설명

이 특성은 예상했던 예외가 throw되는지 테스트하는 데 사용됩니다. 예상했던 예외가 throw되면 테스트에 통과합니다. throw된 예외가 예상했던 예외에서 상속되는 경우 테스트에 실패합니다.

테스트에 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

다음 테스트 메서드에서는 DivisionClass 개체의 Divide 메서드를 테스트합니다. 이 테스트에서는 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(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

ExpectedExceptionAttribute 멤버

Microsoft.VisualStudio.TestTools.UnitTesting 네임스페이스