ExpectedExceptionAttribute Constructor (Type, String)

Initializes a new instance of the ExpectedExceptionAttribute class with and expected exception type and a message that describes the exception.

Namespace:  Microsoft.VisualStudio.TestTools.UnitTesting
Assembly:  Microsoft.VisualStudio.QualityTools.UnitTestFramework (in Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Syntax

'Declaration
Public Sub New ( _
    exceptionType As Type, _
    noExceptionMessage As String _
)

public ExpectedExceptionAttribute(
    Type exceptionType,
    string noExceptionMessage
)

public:
ExpectedExceptionAttribute(
    Type^ exceptionType, 
    String^ noExceptionMessage
)

new : 
        exceptionType:Type * 
        noExceptionMessage:string -> ExpectedExceptionAttribute

public function ExpectedExceptionAttribute(
    exceptionType : Type, 
    noExceptionMessage : String
)

Parameters

• exceptionType
  Type: System.Type
  An expected type of exception to be thrown by a method.

• noExceptionMessage
  Type: System.String

Remarks

If exceptionType or message is nulla null reference (Nothing in Visual Basic), a diagnostic message will be sent to a trace listener.

Examples

The following class contains the method to test:

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

The following test method tests the Divide method of the DivisionClass object. It tests for the existence of a DivideByZeroException.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using MyCSNamespace;

namespace MyCSTestProject
{
    [TestClass()]
    public class DivisionClassTest
    {
        [TestMethod()]
        [ExpectedException(typeof(System.DivideByZeroException), "MyMessage")]
        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

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

ExpectedExceptionAttribute Class

ExpectedExceptionAttribute Overload

Microsoft.VisualStudio.TestTools.UnitTesting Namespace