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 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	RethrowIfAssertException	如果它是 AssertFailedException 或 AssertInconclusiveException，則再次擲回例外狀況。 (繼承自 ExpectedExceptionBaseAttribute)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。
	Verify	基礎架構。 (繼承自 ExpectedExceptionBaseAttribute)。

回頁首

明確介面實作

	名稱	說明
	_Attribute.GetIDsOfNames	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承自 Attribute)。
	_Attribute.GetTypeInfo	擷取物件的型別資訊，可以用來取得介面的型別資訊。 (繼承自 Attribute)。
	_Attribute.GetTypeInfoCount	擷取物件提供的型別資訊介面數目 (0 或 1)。 (繼承自 Attribute)。
	_Attribute.Invoke	提供物件所公開的屬性和方法的存取權。 (繼承自 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

下列測試方法會測試 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

執行緒安全

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

請參閱

參考

Microsoft.VisualStudio.TestTools.UnitTesting 命名空間