ExpectedExceptionAttribute – třída

Označuje, že výjimka se očekává během provádění zkušební metody. Od této třídy nelze dědit.

Hierarchie dědičnosti

System.Object
  System.Attribute
    Microsoft.VisualStudio.TestTools.UnitTesting.ExpectedExceptionBaseAttribute
      Microsoft.VisualStudio.TestTools.UnitTesting.ExpectedExceptionAttribute

Obor názvů:  Microsoft.VisualStudio.TestTools.UnitTesting
Sestavení:  Microsoft.VisualStudio.QualityTools.UnitTestFramework (v Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll)

Syntaxe

'Deklarace
<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

Typ ExpectedExceptionAttribute zveřejňuje následující členy.

Konstruktory

	Název	Popis
	ExpectedExceptionAttribute(Type)	Inicializuje novou instanci ExpectedExceptionAttribute třídy s očekávanou výjimku.
	ExpectedExceptionAttribute(Type, String)	Inicializuje novou instanci ExpectedExceptionAttribute třídy a typ výjimky očekávané a zpráva popisující výjimku.

Na začátek

Vlastnosti

	Název	Popis
	AllowDerivedTypes
	ExceptionType	Typ výjimky očekávané získá.
	NoExceptionMessage	Infrastruktura. (Zděděno z ExpectedExceptionBaseAttribute.)
	TestContext	Infrastruktura. (Zděděno z ExpectedExceptionBaseAttribute.)
	TypeId	Po implementaci v odvozené třídě získává tento jedinečný identifikátor Attribute. (Zděděno z Attribute.)

Na začátek

Metody

	Název	Popis
	Equals	Infrastruktura. Vrátí hodnotu, která označuje, zda je zadaný objekt rovna této instance. (Zděděno z Attribute.)
	Finalize	Umožňuje zkuste uvolnit prostředky a provádět další operace vyčištění před je převzaty systémem pro uvolnění objektu. (Zděděno z Object.)
	GetHashCode	Vrátí kód hash pro tuto instanci. (Zděděno z Attribute.)
	GetType	Získává Type aktuální instance. (Zděděno z Object.)
	IsDefaultAttribute	Přepsat v odvozené třídě označuje, zda hodnota této instance je výchozí hodnota pro odvozené třídy. (Zděděno z Attribute.)
	Match	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda tato instance se rovná zadaný objekt. (Zděděno z Attribute.)
	MemberwiseClone	Vytvoří kopii aktuální Object. (Zděděno z Object.)
	RethrowIfAssertException	Vygeneruje výjimku znovu, pokud se jedná AssertFailedException nebo AssertInconclusiveException. (Zděděno z ExpectedExceptionBaseAttribute.)
	ToString	Vrátí řetězec, který představuje aktuální objekt. (Zděděno z Object.)
	Verify	Infrastruktura. (Zděděno z ExpectedExceptionBaseAttribute.)

Na začátek

Explicitní implementace rozhraní

	Název	Popis
	_Attribute.GetIDsOfNames	Mapuje sadu názvů identifikátorů odeslání odpovídající sadu. (Zděděno z Attribute.)
	_Attribute.GetTypeInfo	Načte informace o typu objektu, který lze získat informace o rozhraní typu. (Zděděno z Attribute.)
	_Attribute.GetTypeInfoCount	Vyhledá číslo rozhraní typu informací, že objekt obsahuje (0 nebo 1). (Zděděno z Attribute.)
	_Attribute.Invoke	Poskytuje přístup k vlastnostem a metodám vystaven objekt. (Zděděno z Attribute.)

Na začátek

Poznámky

Tento atribut slouží k ověření, zda očekávané výjimka. Zkušební metoda předá, jestliže očekávaná výjimka. Test se nezdaří, pokud thrown výjimku dědí očekávaná výjimka.

Pokud test i atribut ExpectedException a Assert prohlášení, buď jeden může způsobit test nezdaří. Zjistěte, zda prohlášení nebo atribut test nezdaří, poklepáním otevřete stránku podrobností výsledky testu výsledek zkoušky. Další informace o výsledky testů naleznete Test Results Reported.

Tento atribut může být zadán pro metodu. Může být pouze jedna instance tohoto atributu pro metodu.

Další informace o použití atributů viz Rozšíření metadat pomocí atributů.

Příklady

Metoda testování obsahuje následující třídy:

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

Následující zkušební metody zkoušek dělení metodu DivisionClass objektu. Testuje přítomnost 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

Zabezpečení podprocesu

Všechny veřejné členy static (Shared v jazyce Visual Basic) tohoto typu jsou zabezpečeny pro používání podprocesů. Zabezpečení sdílených členů pro používání podprocesů není zaručeno.

Viz také

Odkaz

Microsoft.VisualStudio.TestTools.UnitTesting – obor názvů