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

備註

這個屬性可用來測試是否擲回預期的例外狀況。如果擲回預期的例外狀況，則測試方法將會成功。如果擲回的例外狀況是繼承自預期的例外狀況，則測試將會失敗。

如果測試同時具有 ExpectedException 屬性和 Assert 陳述式 (Statement)，則任何一個項目都可能導致測試失敗。若要判斷是屬性還是陳述式導致測試失敗，請按兩下測試結果，即可開啟測試的結果詳細資料頁面。如需測試結果的詳細資訊，請參閱已報告的測試結果。

這個屬性可以在方法上指定。這個屬性在同一個方法上只能有一個執行個體。

如需如何使用屬性的詳細資訊，請參閱使用屬性擴充中繼資料。

範例

下列類別包含要測試的方法：

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

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

ExpectedExceptionAttribute 成員

Microsoft.VisualStudio.TestTools.UnitTesting 命名空間