ExpectedExceptionAttribute 클래스

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

상속 계층 구조

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

네임스페이스:  Microsoft.VisualStudio.TestTools.UnitTesting
어셈블리:  Microsoft.VisualStudio.QualityTools.UnitTestFramework(Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

구문

‘선언
<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple := False, Inherited := True)> _
Public NotInheritable Class ExpectedExceptionAttribute _
    Inherits ExpectedExceptionBaseAttribute

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

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

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, AllowMultiple = false, Inherited = true)>]
type ExpectedExceptionAttribute =  
    class
        inherit ExpectedExceptionBaseAttribute
    end

public final class ExpectedExceptionAttribute extends ExpectedExceptionBaseAttribute

ExpectedExceptionAttribute 형식에서는 다음과 같은 멤버를 노출합니다.

생성자

	이름	설명
	ExpectedExceptionAttribute(Type)	예상되는 예외를 사용하여 ExpectedExceptionAttribute 클래스의 새 인스턴스를 초기화합니다.
	ExpectedExceptionAttribute(Type, String)	예상되는 예외 형식과 예외를 설명하는 메시지를 사용하여 ExpectedExceptionAttribute 클래스의 새 인스턴스를 초기화합니다.

위쪽

속성

	이름	설명
	AllowDerivedTypes
	ExceptionType	예상되는 예외 형식을 가져옵니다.
	NoExceptionMessage	인프라입니다. (ExpectedExceptionBaseAttribute에서 상속됨)
	TestContext	인프라입니다. (ExpectedExceptionBaseAttribute에서 상속됨)
	TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (Attribute에서 상속됨)

위쪽

메서드

	이름	설명
	Equals	인프라입니다. 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
	Finalize	가비지 수집에서 회수하기 전에 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
	GetHashCode	이 인스턴스에 대한 해시 코드를 반환합니다. (Attribute에서 상속됨)
	GetType	현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
	IsDefaultAttribute	파생 클래스에서 재정의된 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (Attribute에서 상속됨)
	Match	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
	MemberwiseClone	현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
	RethrowIfAssertException	AssertFailedException 또는 AssertInconclusiveException인 경우 예외를 다시 throw합니다. (ExpectedExceptionBaseAttribute에서 상속됨)
	ToString	현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
	Verify	인프라입니다. (ExpectedExceptionBaseAttribute에서 상속됨)

위쪽

명시적 인터페이스 구현

	이름	설명
	_Attribute.GetIDsOfNames	이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다. (Attribute에서 상속됨)
	_Attribute.GetTypeInfo	인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (Attribute에서 상속됨)
	_Attribute.GetTypeInfoCount	개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (Attribute에서 상속됨)
	_Attribute.Invoke	개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다. (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

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

참고 항목

참조

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