다음을 통해 공유


MSTEST0006: [ExpectedException] 방지

속성
규칙 ID MSTEST0006
타이틀 [ExpectedException] 방지
범주 디자인
수정 사항이 주요 변경인지 여부 주요 변경 아님
기본적으로 사용하도록 설정됨
기본 심각도 정보
버전에서 도입됨 3.2.0
코드 수정이 있나요? 예, 3.7.0부터

원인

메서드는 [ExpectedException] 특성으로 표시됩니다.

규칙 설명

Assert.ThrowsException 특성보다 Assert.ThrowsExceptionAsync 또는 Assert.ThrowsExactly(또는 MSTest 3.8 이상을 사용하는 경우 /Assert.ThrowsAssert.ThrowsExactlyAsync 또는 /Assert.ThrowsAsync[ExpectedException])를 사용하는 것이 좋습니다. 이는 테스트의 전체 본문이 아닌, 예상된 예외가 예상된 코드 줄에서만 발생하도록 보장하기 때문입니다. 또한 Assert API는 더 많은 유연성을 제공하고 예외의 추가 속성을 어설션할 수 있도록 해줍니다.

[TestClass]
public class TestClass
{
    [TestMethod]
    [ExpectedException(typeof(InvalidOperationException))] // Violation
    public void TestMethod()
    {
        // Arrange
        var person = new Person
        {
            FirstName = "John", 
            LastName = "Doe",
        };
        person.SetAge(-1);

        // Act
        person.GrowOlder();
    }
}

위반 문제를 해결하는 방법

[ExpectedException] 특성의 사용을 Assert.ThrowsException 또는 Assert.ThrowsExceptionAsync 호출로 바꿉니다(또는 MSTest 3.8 이상을 사용하는 경우 Assert.ThrowsExactly/Assert.Throws 또는 Assert.ThrowsExactlyAsync/Assert.ThrowsAsync).

[TestClass]
public class TestClass
{
    [TestMethod]
    public void TestMethod()
    {
        // Arrange
        var person = new Person
        {
            FirstName = "John", 
            LastName = "Doe",
        };
        person.SetAge(-1);

        // Act
        Assert.ThrowsExactly(() => person.GrowOlder());
    }
}

경고를 표시하지 않는 경우

메서드가 한 줄이면 이 진단을 표시하지 않는 것이 안전합니다.

[TestClass]
public class TestClass
{
    [TestMethod]
    [ExpectedException(typeof(ArgumentNullException))]
    public void TestMethod()
    {
        new Person(null);
    }
}

경고 표시 안 함

단일 위반을 억제하려면, 소스 파일에 전처리기 지시문을 추가하여 규칙을 비활성화한 다음 다시 활성화하세요.

#pragma warning disable MSTEST0006
// The code that's violating the rule is on this line.
#pragma warning restore MSTEST0006

파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 해당 심각도를 none 설정합니다.

[*.{cs,vb}]
dotnet_diagnostic.MSTEST0006.severity = none

자세한 내용은 코드 분석 경고표시하지 않는 방법을 참조하세요.