ExpectedExceptionBaseAttribute - класс

Это базовый класс для атрибутов, указывающих ожидать исключение из модульного теста.

Иерархия наследования

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 MustInherit Class ExpectedExceptionBaseAttribute _
    Inherits Attribute

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

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

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

public abstract class ExpectedExceptionBaseAttribute extends Attribute

Тип ExpectedExceptionBaseAttribute предоставляет следующие члены.

Конструкторы

	Имя	Описание
	ExpectedExceptionBaseAttribute()	Инициализирует новый экземпляр класса ExpectedExceptionBaseAttribute.
	ExpectedExceptionBaseAttribute(String)	Инициализирует новый экземпляр класса ExpectedExceptionBaseAttribute.

В начало страницы

Свойства

	Имя	Описание
	NoExceptionMessage	Инфраструктура.
	TestContext	Инфраструктура.
	TypeId	При реализации в производном классе возвращает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute.)

В начало страницы

Методы

	Имя	Описание
	Equals	Инфраструктура. Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute.)
	Finalize	Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
	GetHashCode	Возвращает хеш-код данного экземпляра. (Унаследовано от Attribute.)
	GetType	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
	IsDefaultAttribute	При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute.)
	Match	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute.)
	MemberwiseClone	Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
	RethrowIfAssertException	Снова создает это исключение, если это исключение AssertFailedException или AssertInconclusiveException.
	ToString	Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)
	Verify	Инфраструктура.

В начало страницы

Явные реализации интерфейса

	Имя	Описание
	_Attribute.GetIDsOfNames	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfo	Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса. (Унаследовано от Attribute.)
	_Attribute.GetTypeInfoCount	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute.)
	_Attribute.Invoke	Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute.)

В начало страницы

Заметки

Путем реализации собственной проверки ожидаемых исключений можно указать дополнительные сведения и требования, которые встроенные методы класса ExpectedExceptionAttribute не могут обработать, как показано ниже:

• Проверка состояния исключения.

• Ожидается более одного типа исключения.

• Отображение настраиваемого сообщения при вызове исключения неправильного типа.

• Управление результатами отрицательного теста.

• Дополнительные сведения об использовании атрибутов см. в разделе Расширение метаданных с помощью атрибутов.

Примеры

Следующий класс содержит тестируемый метод.

using System;

namespace CSExample
{
    public class DivisionClass
    {
        private int fraction;

        public int Divide(int numerator, int denominator)
        {
            return numerator / denominator;
        }
    }
}

Следующий класс настраиваемых атрибутов, ExpectedArithmeticException, наследуется от класса ExpectedExceptionBaseAttribute для проверки типа исключения и сообщения. Атрибут ExpectedArithmeticException проверяет, что метод теста выдает исключение типа, который является производным от System.ArithmeticException. Он также проверяет, что сообщение об исключении соответствует указанному сообщению об исключении. Модульный тест будет пройден, так как он выдает исключение DivideByZeroException, производное от исключения ArithmeticException, а сообщение указанного исключения соответствует сообщению исключения, выдаваемого модульным тестом.

using CSExample;
using Microsoft.VisualStudio.TestTools.UnitTesting;
namespace TestProject1
{
    public sealed class ExpectedArithmeticException : ExpectedExceptionBaseAttribute
    {
        private string exceptionMessage;
        private string wrongExceptionMessage;

        public string WrongExceptionMessage
        {
            get
            {
                return wrongExceptionMessage;
            }
            set
            {
                wrongExceptionMessage = value;
            }
        }

        public ExpectedArithmeticException(string expectedExceptionMessage) : this(expectedExceptionMessage, "No exception was thrown.")
        {
        }

        public ExpectedArithmeticException(string expectedExceptionMessage, string noExceptionMessage)
            : base(noExceptionMessage)
        {
            exceptionMessage = expectedExceptionMessage;
            WrongExceptionMessage = "The exception that was thrown does not derive from System.ArithmeticException.";
        }

        protected override void Verify(System.Exception exception)
        {
            Assert.IsNotNull(exception);

            // Handle assertion exceptions from assertion failures in the test method, since we are not interested in verifying those
            base.RethrowIfAssertException(exception);

            Assert.IsInstanceOfType(exception, typeof(System.ArithmeticException), wrongExceptionMessage);
            Assert.AreEqual(exceptionMessage, exception.Message, "Could not verify the exception message.");
        }
    }


    [TestClass()]
    public class DivisionClassTest
    {

        /* This test will pass because it thows a System.DivideByZeroException which derives from System.ArithmeticException. */
        [TestMethod()]
        [ExpectedArithmeticException("Attempted to divide by zero.", "An exception was expected, but no exception was thrown.", WrongExceptionMessage = "The wrong type of exception was thrown.")]
        public void DivideTest()
        {
            DivisionClass target = new DivisionClass();
            int numerator = 5;
            int denominator = 0;
            int actual;
            actual = target.Divide(numerator, denominator);
        }

    }
}

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.VisualStudio.TestTools.UnitTesting - пространство имен