Tutorial: Testar uma biblioteca de classes .NET com o .NET usando o Visual Studio

  • Artigo

Este tutorial mostra como automatizar o teste de unidade adicionando um projeto de teste a uma solução.

Pré-requisitos

Criar um projeto de teste de unidade

As unidade de teste fornecem testes de software automatizados durante o desenvolvimento e a publicação. MSTest é uma das três estruturas de teste que você pode escolher. As outras são xUnit e nUnit.

  1. Inicie o Visual Studio.

  2. Abra a solução ClassLibraryProjects criada em Criar uma biblioteca de classes do .NET usando o Visual Studio.

  3. Adicione um novo projeto de teste de unidade chamado "StringLibraryTest" à solução.

    1. Clique com o botão direito do mouse na solução em Gerenciador de Soluções e escolha Adicionar>Novo projeto.

    2. Na página Adicionar um novo projeto, insira mstest na caixa de pesquisa. Escolha C# ou Visual Basic na lista Linguagem e depois Todas as plataformas na lista Plataforma.

    3. Escolha o modelo do Projeto de Teste MSTest e, em seguida, Avançar.

    4. Na página Configurar seu novo projeto, insira StringLibraryTest na caixa Nome do projeto. Em seguida, escolha Avançar.

    5. Na página Informações Adicionais, selecione .NET 8 (Prévia) na caixa Framework. Em seguida, escolha Criar.

  4. O Visual Studio cria o projeto e abre o arquivo de classe na janela do código, com o código a seguir. Se a linguagem que você quer usar não aparecer, altere o seletor de linguagem na parte superior da página.

    namespace StringLibraryTest;

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestMethod1()
    {
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Sub TestSub()

        End Sub
    End Class
End Namespace

    O código-fonte criado pelo modelo de teste de unidade faz o seguinte:

    Cada método marcado com [TestMethod] em uma classe de teste marcada com [TestClass] é executado automaticamente quando o teste de unidade é executado.

Adicionar uma referência ao projeto

Para que o projeto de teste funcione com a classe StringLibrary, adicione uma referência no projeto StringLibraryTest ao projeto StringLibrary.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Dependências do projeto StringLibraryTest e selecione Adicionar Referência do Projeto no menu de contexto.

  2. Na caixa de diálogo Gerenciador de Referências, expanda o nó Projetos e selecione a caixa ao lado de StringLibrary. A adição de uma referência ao assembly StringLibrary permite que o compilador localize os métodos StringLibrary durante a compilação do projeto StringLibraryTest.

  3. Selecione OK.

Adicionar e executar métodos de teste de unidade

Quando o Visual Studio executa um teste de unidade, ele executa cada método marcado com o atributo TestMethodAttribute em uma classe marcada com o atributo TestClassAttribute. Um método de teste termina quando a primeira falha é encontrada ou quando todos os testes contidos no método têm êxito.

Os testes mais comuns chamam membros da classe Assert. Muitos métodos assert incluem pelo menos dois parâmetros, um deles é o resultado esperado do teste, e o outro é o resultado real do teste. Alguns dos métodos chamados com mais frequência da classe Assert são mostrados na tabela a seguir:

Métodos assert Função
Assert.AreEqual Verifica se os dois valores ou objetos são iguais. O assert falha se os valores ou objetos não forem iguais.
Assert.AreSame Verifica se duas variáveis de objeto se referem ao mesmo objeto. A assert falhará se as variáveis se referirem a objetos diferentes.
Assert.IsFalse Verifica se uma condição é false. O assert falhará se a condição for true.
Assert.IsNotNull Verifica se um objeto não é null. A assert falhará se o objeto for null.

Você também pode usar o método Assert.ThrowsException em um método de teste para indicar o tipo de exceção que ele deve gerar. O teste falhará se a exceção especificada não for lançada.

Ao testar o método StringLibrary.StartsWithUpper, você quer fornecer um número de cadeias de caracteres que comecem com um caractere maiúsculo. Você espera que o método retorne true nesses casos, para que possa chamar o método Assert.IsTrue. Da mesma forma, você deseja fornecer um número de cadeias de caracteres que comecem com algo diferente de um caractere maiúsculo. Você espera que o método retorne false nesses casos, para que possa chamar o método Assert.IsFalse.

Como seu método de biblioteca lida com cadeias de caracteres, convém ter certeza de que ele manipulará com êxito uma cadeia de caracteres vazia (String.Empty), uma cadeia de caracteres válida sem caracteres e cujo Length é 0 e uma cadeia de caracteres null que não foi inicializada. Você pode chamar StartsWithUpper diretamente como um método estático e passar um único argumento String. Ou você pode chamar StartsWithUpper como um método de extensão em uma variável string atribuída a null.

Você definirá três métodos, cada um deles chamará um método Assert para cada elemento em uma matriz de cadeia de caracteres. Você chamará uma sobrecarga de método que permite especificar uma mensagem de erro a ser exibida em caso de falha no teste. A mensagem identifica a cadeia de caracteres que causou a falha.

Para criar os métodos de teste:

  1. Na janela de código UnitTest1.cs ou UnitTest1.vb, substitua o código pelo seguinte:

    using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result,
                       string.Format("Expected for '{0}': true; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = { string.Empty, null };
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word == null ? "<null>" : word, result));
            }
        }
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports UtilityLibraries

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Public Sub TestStartsWithUpper()
            ' Tests that we expect to return true.
            Dim words() As String = {"Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsTrue(result,
                       $"Expected for '{word}': true; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub TestDoesNotStartWithUpper()
            ' Tests that we expect to return false.
            Dim words() As String = {"alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " "}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsFalse(result,
                       $"Expected for '{word}': false; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub DirectCallWithNullOrEmpty()
            ' Tests that we expect to return false.
            Dim words() As String = {String.Empty, Nothing}
            For Each word In words
                Dim result As Boolean = StringLibrary.StartsWithUpper(word)
                Assert.IsFalse(result,
                       $"Expected for '{If(word Is Nothing, "<null>", word)}': false; Actual: {result}")
            Next
        End Sub
    End Class
End Namespace

    O teste de caracteres maiúsculos no método TestStartsWithUpper inclui a letra maiúscula grega alfa (U+0391) e a letra maiúscula cirílica EM (U+041C). O teste de caracteres minúsculos no método TestDoesNotStartWithUpper inclui a letra minúscula grega alfa (U+03B1) e a letra minúscula cirílica Ghe (U+0433).

  2. Na barra de menus, selecione Arquivo>Salvar UnitTest1.cs Como ou Arquivo>Salvar UnitTest1.vb Como. Na caixa de diálogo Salvar Arquivo Como, selecione a seta ao lado do botão Salvar e selecione Salvar com Codificação.

    Visual Studio Save File As dialog

  3. Na caixa de diálogo Confirmar Salvar Como, selecione o botão Sim para salvar o arquivo.

  4. Na caixa de diálogo Opções Avançadas de Salvamento, selecione Unicode (UTF-8 com assinatura) – página de código 65001 na lista suspensa Codificação e selecione OK.

    Visual Studio Advanced Save Options dialog

    Se você não salvar seu código-fonte como um arquivo codificado em UTF8, o Visual Studio poderá salvá-lo como um arquivo ASCII. Quando isso acontecer, o runtime não decodificará de forma precisa os caracteres UTF8 fora do intervalo ASCII e os resultados de teste não serão corretos.

  5. Na barra de menus, selecione Testar>Executar Todos os Testes. Se a janela do Gerenciador de Testes não abrir, abra-a escolhendo Teste>Gerenciador de Testes. Os três testes estão listados na seção Testes Aprovados, e a seção Resumo relata o resultado da execução de teste.

    Test Explorer window with passing tests

Identificar falhas de teste

Se você estiver fazendo o TDD (Desenvolvimento Orientado por Testes), você grava os testes primeiro e eles falharão na execução. Em seguida, você adiciona o código ao aplicativo que faz com que o teste seja bem-sucedido. Neste tutorial, você criou o teste depois de gravar o código do aplicativo que ele valida, portanto, você não viu o teste falhar. Para validar se um teste falha conforme o esperado, adicione um valor inválido à entrada de teste.

  1. Modifique a matriz words no método TestDoesNotStartWithUpper para incluir a cadeia de caracteres “Error”. Não é necessário salvar o arquivo porque o Visual Studio salva automaticamente os arquivos abertos quando uma solução é criada para executar testes.

    string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

    Dim words() As String = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " }

  2. Execute o teste selecionando Testar>Executar Todos os Testes na barra de menus. A Janela Gerenciador de Testes indica que dois testes tiveram êxito e um falhou.

    Test Explorer window with failing tests

  3. Selecione o teste com falha, TestDoesNotStartWith.

    A janela Gerenciador de Testes mostra a mensagem produzida pelo assert: "Assert.IsFalse falhou. Esperado para 'Error': false, real: True". Devido à falha, nenhuma cadeia de caracteres na matriz após "Error" foi testada.

    Test Explorer window showing the IsFalse assertion failure

  4. Remova a cadeia de caracteres "Error" que você adicionou na etapa 1. Execute novamente o teste, e ele será aprovado.

Testar a versão de lançamento da biblioteca

Agora que todos os nossos testes foram aprovados ao executar a compilação de Depuração da biblioteca, execute os testes mais uma vez na compilação de Lançamento da biblioteca. Vários fatores, incluindo as otimizações do compilador, podem produzir um comportamento diferente entre as compilações de Depuração e Lançamento.

Para testar a compilação de Lançamento:

  1. Na barra de ferramentas do Visual Studio, altere a configuração de compilação de Depurar para Lançamento.

    Visual Studio toolbar with release build highlighted

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto StringLibrary e selecione Compilar no menu de contexto para recompilar a biblioteca.

    StringLibrary context menu with build command

  3. Execute os testes de unidade escolhendo Testar>Executar todos os testes da barra de menu. Os testes são aprovados.

Depurar testes

Se você estiver usando o Visual Studio como seu IDE, será possível usar o mesmo processo mostrado no Tutorial: Depurar um aplicativo de console do .NET usando o Visual Studio para depurar o código usando seu projeto de teste de unidade. Em vez de iniciar o projeto do aplicativo ShowCase, clique com o botão direito do mouse no projeto StringLibraryTests e selecione Testes de Depuração no menu de contexto.

O Visual Studio inicia o projeto de teste com o depurador anexado. A execução será interrompida em qualquer ponto de interrupção adicionado ao projeto de teste ou ao código da biblioteca subjacente.

Recursos adicionais

Próximas etapas

Neste tutorial, você testou uma biblioteca de classes. Você pode disponibilizar a biblioteca para outras pessoas publicando-a no NuGet como um pacote. Para saber como, siga um tutorial do NuGet:

Criar e publicar um pacote NuGet usando o Visual Studio

Se você publicar uma biblioteca como um pacote NuGet, outras pessoas poderão instalá-la e usá-la. Para saber como, siga um tutorial do NuGet:

Instalar e usar um pacote no Visual Studio

Uma biblioteca não precisa ser distribuída como um pacote. Ela pode ser empacotada com um aplicativo de console que a usa. Para saber como publicar um aplicativo de console, consulte o tutorial anterior nesta série:

Publicar um aplicativo de console .NET usando o Visual Studio

Este tutorial mostra como automatizar o teste de unidade adicionando um projeto de teste a uma solução.

Pré-requisitos

Criar um projeto de teste de unidade

As unidade de teste fornecem testes de software automatizados durante o desenvolvimento e a publicação. MSTest é uma das três estruturas de teste que você pode escolher. As outras são xUnit e nUnit.

  1. Inicie o Visual Studio.

  2. Abra a solução ClassLibraryProjects criada em Criar uma biblioteca de classes do .NET usando o Visual Studio.

  3. Adicione um novo projeto de teste de unidade chamado "StringLibraryTest" à solução.

    1. Clique com o botão direito do mouse na solução em Gerenciador de Soluções e escolha Adicionar>Novo projeto.

    2. Na página Adicionar um novo projeto, insira mstest na caixa de pesquisa. Escolha C# ou Visual Basic na lista Linguagem e depois Todas as plataformas na lista Plataforma.

    3. Escolha o modelo do Projeto de Teste MSTest e, em seguida, Avançar.

    4. Na página Configurar seu novo projeto, insira StringLibraryTest na caixa Nome do projeto. Em seguida, escolha Avançar.

    5. Na página Informações adicionais, selecione .NET 7 (suporte de prazo standard) na caixa Estrutura. Em seguida, escolha Criar.

  4. O Visual Studio cria o projeto e abre o arquivo de classe na janela do código, com o código a seguir. Se a linguagem que você quer usar não aparecer, altere o seletor de linguagem na parte superior da página.

    using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Sub TestSub()

        End Sub
    End Class
End Namespace

    O código-fonte criado pelo modelo de teste de unidade faz o seguinte:

    Cada método marcado com [TestMethod] em uma classe de teste marcada com [TestClass] é executado automaticamente quando o teste de unidade é executado.

Adicionar uma referência ao projeto

Para que o projeto de teste funcione com a classe StringLibrary, adicione uma referência no projeto StringLibraryTest ao projeto StringLibrary.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Dependências do projeto StringLibraryTest e selecione Adicionar Referência do Projeto no menu de contexto.

  2. Na caixa de diálogo Gerenciador de Referências, expanda o nó Projetos e selecione a caixa ao lado de StringLibrary. A adição de uma referência ao assembly StringLibrary permite que o compilador localize os métodos StringLibrary durante a compilação do projeto StringLibraryTest.

  3. Selecione OK.

Adicionar e executar métodos de teste de unidade

Quando o Visual Studio executa um teste de unidade, ele executa cada método marcado com o atributo TestMethodAttribute em uma classe marcada com o atributo TestClassAttribute. Um método de teste termina quando a primeira falha é encontrada ou quando todos os testes contidos no método têm êxito.

Os testes mais comuns chamam membros da classe Assert. Muitos métodos assert incluem pelo menos dois parâmetros, um deles é o resultado esperado do teste, e o outro é o resultado real do teste. Alguns dos métodos chamados com mais frequência da classe Assert são mostrados na tabela a seguir:

Métodos assert Função
Assert.AreEqual Verifica se os dois valores ou objetos são iguais. O assert falha se os valores ou objetos não forem iguais.
Assert.AreSame Verifica se duas variáveis de objeto se referem ao mesmo objeto. A assert falhará se as variáveis se referirem a objetos diferentes.
Assert.IsFalse Verifica se uma condição é false. O assert falhará se a condição for true.
Assert.IsNotNull Verifica se um objeto não é null. A assert falhará se o objeto for null.

Você também pode usar o método Assert.ThrowsException em um método de teste para indicar o tipo de exceção que ele deve gerar. O teste falhará se a exceção especificada não for lançada.

Ao testar o método StringLibrary.StartsWithUpper, você quer fornecer um número de cadeias de caracteres que comecem com um caractere maiúsculo. Você espera que o método retorne true nesses casos, para que possa chamar o método Assert.IsTrue. Da mesma forma, você deseja fornecer um número de cadeias de caracteres que comecem com algo diferente de um caractere maiúsculo. Você espera que o método retorne false nesses casos, para que possa chamar o método Assert.IsFalse.

Como seu método de biblioteca lida com cadeias de caracteres, convém ter certeza de que ele manipulará com êxito uma cadeia de caracteres vazia (String.Empty), uma cadeia de caracteres válida sem caracteres e cujo Length é 0 e uma cadeia de caracteres null que não foi inicializada. Você pode chamar StartsWithUpper diretamente como um método estático e passar um único argumento String. Ou você pode chamar StartsWithUpper como um método de extensão em uma variável string atribuída a null.

Você definirá três métodos, cada um deles chamará um método Assert para cada elemento em uma matriz de cadeia de caracteres. Você chamará uma sobrecarga de método que permite especificar uma mensagem de erro a ser exibida em caso de falha no teste. A mensagem identifica a cadeia de caracteres que causou a falha.

Para criar os métodos de teste:

  1. Na janela de código UnitTest1.cs ou UnitTest1.vb, substitua o código pelo seguinte:

    using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result,
                       string.Format("Expected for '{0}': true; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = { string.Empty, null };
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word == null ? "<null>" : word, result));
            }
        }
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports UtilityLibraries

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Public Sub TestStartsWithUpper()
            ' Tests that we expect to return true.
            Dim words() As String = {"Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsTrue(result,
                       $"Expected for '{word}': true; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub TestDoesNotStartWithUpper()
            ' Tests that we expect to return false.
            Dim words() As String = {"alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " "}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsFalse(result,
                       $"Expected for '{word}': false; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub DirectCallWithNullOrEmpty()
            ' Tests that we expect to return false.
            Dim words() As String = {String.Empty, Nothing}
            For Each word In words
                Dim result As Boolean = StringLibrary.StartsWithUpper(word)
                Assert.IsFalse(result,
                       $"Expected for '{If(word Is Nothing, "<null>", word)}': false; Actual: {result}")
            Next
        End Sub
    End Class
End Namespace

    O teste de caracteres maiúsculos no método TestStartsWithUpper inclui a letra maiúscula grega alfa (U+0391) e a letra maiúscula cirílica EM (U+041C). O teste de caracteres minúsculos no método TestDoesNotStartWithUpper inclui a letra minúscula grega alfa (U+03B1) e a letra minúscula cirílica Ghe (U+0433).

  2. Na barra de menus, selecione Arquivo>Salvar UnitTest1.cs Como ou Arquivo>Salvar UnitTest1.vb Como. Na caixa de diálogo Salvar Arquivo Como, selecione a seta ao lado do botão Salvar e selecione Salvar com Codificação.

    Visual Studio Save File As dialog

  3. Na caixa de diálogo Confirmar Salvar Como, selecione o botão Sim para salvar o arquivo.

  4. Na caixa de diálogo Opções Avançadas de Salvamento, selecione Unicode (UTF-8 com assinatura) – página de código 65001 na lista suspensa Codificação e selecione OK.

    Visual Studio Advanced Save Options dialog

    Se você não salvar seu código-fonte como um arquivo codificado em UTF8, o Visual Studio poderá salvá-lo como um arquivo ASCII. Quando isso acontecer, o runtime não decodificará de forma precisa os caracteres UTF8 fora do intervalo ASCII e os resultados de teste não serão corretos.

  5. Na barra de menus, selecione Testar>Executar Todos os Testes. Se a janela do Gerenciador de Testes não abrir, abra-a escolhendo Teste>Gerenciador de Testes. Os três testes estão listados na seção Testes Aprovados, e a seção Resumo relata o resultado da execução de teste.

    Test Explorer window with passing tests

Identificar falhas de teste

Se você estiver fazendo o TDD (Desenvolvimento Orientado por Testes), você grava os testes primeiro e eles falharão na execução. Em seguida, você adiciona o código ao aplicativo que faz com que o teste seja bem-sucedido. Neste tutorial, você criou o teste depois de gravar o código do aplicativo que ele valida, portanto, você não viu o teste falhar. Para validar se um teste falha conforme o esperado, adicione um valor inválido à entrada de teste.

  1. Modifique a matriz words no método TestDoesNotStartWithUpper para incluir a cadeia de caracteres “Error”. Não é necessário salvar o arquivo porque o Visual Studio salva automaticamente os arquivos abertos quando uma solução é criada para executar testes.

    string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

    Dim words() As String = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " }

  2. Execute o teste selecionando Testar>Executar Todos os Testes na barra de menus. A Janela Gerenciador de Testes indica que dois testes tiveram êxito e um falhou.

    Test Explorer window with failing tests

  3. Selecione o teste com falha, TestDoesNotStartWith.

    A janela Gerenciador de Testes mostra a mensagem produzida pelo assert: "Assert.IsFalse falhou. Esperado para 'Error': false, real: True". Devido à falha, nenhuma cadeia de caracteres na matriz após "Error" foi testada.

    Test Explorer window showing the IsFalse assertion failure

  4. Remova a cadeia de caracteres "Error" que você adicionou na etapa 1. Execute novamente o teste, e ele será aprovado.

Testar a versão de lançamento da biblioteca

Agora que todos os nossos testes foram aprovados ao executar a compilação de Depuração da biblioteca, execute os testes mais uma vez na compilação de Lançamento da biblioteca. Vários fatores, incluindo as otimizações do compilador, podem produzir um comportamento diferente entre as compilações de Depuração e Lançamento.

Para testar a compilação de Lançamento:

  1. Na barra de ferramentas do Visual Studio, altere a configuração de compilação de Depurar para Lançamento.

    Visual Studio toolbar with release build highlighted

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto StringLibrary e selecione Compilar no menu de contexto para recompilar a biblioteca.

    StringLibrary context menu with build command

  3. Execute os testes de unidade escolhendo Testar>Executar todos os testes da barra de menu. Os testes são aprovados.

Depurar testes

Se você estiver usando o Visual Studio como seu IDE, será possível usar o mesmo processo mostrado no Tutorial: Depurar um aplicativo de console do .NET usando o Visual Studio para depurar o código usando seu projeto de teste de unidade. Em vez de iniciar o projeto do aplicativo ShowCase, clique com o botão direito do mouse no projeto StringLibraryTests e selecione Testes de Depuração no menu de contexto.

O Visual Studio inicia o projeto de teste com o depurador anexado. A execução será interrompida em qualquer ponto de interrupção adicionado ao projeto de teste ou ao código da biblioteca subjacente.

Recursos adicionais

Próximas etapas

Neste tutorial, você testou uma biblioteca de classes. Você pode disponibilizar a biblioteca para outras pessoas publicando-a no NuGet como um pacote. Para saber como, siga um tutorial do NuGet:

Criar e publicar um pacote NuGet usando o Visual Studio

Se você publicar uma biblioteca como um pacote NuGet, outras pessoas poderão instalá-la e usá-la. Para saber como, siga um tutorial do NuGet:

Instalar e usar um pacote no Visual Studio

Uma biblioteca não precisa ser distribuída como um pacote. Ela pode ser empacotada com um aplicativo de console que a usa. Para saber como publicar um aplicativo de console, consulte o tutorial anterior nesta série:

Publicar um aplicativo de console .NET usando o Visual Studio

Este tutorial mostra como automatizar o teste de unidade adicionando um projeto de teste a uma solução.

Pré-requisitos

Criar um projeto de teste de unidade

As unidade de teste fornecem testes de software automatizados durante o desenvolvimento e a publicação. MSTest é uma das três estruturas de teste que você pode escolher. As outras são xUnit e nUnit.

  1. Inicie o Visual Studio.

  2. Abra a solução ClassLibraryProjects criada em Criar uma biblioteca de classes do .NET usando o Visual Studio.

  3. Adicione um novo projeto de teste de unidade chamado "StringLibraryTest" à solução.

    1. Clique com o botão direito do mouse na solução em Gerenciador de Soluções e escolha Adicionar>Novo projeto.

    2. Na página Adicionar um novo projeto, insira mstest na caixa de pesquisa. Escolha C# ou Visual Basic na lista Linguagem e depois Todas as plataformas na lista Plataforma.

    3. Escolha o modelo do Projeto de Teste MSTest e, em seguida, Avançar.

    4. Na página Configurar seu novo projeto, insira StringLibraryTest na caixa Nome do projeto. Em seguida, escolha Avançar.

    5. Na página Informações adicionais, selecione .NET 6 (suporte de longo prazo) na caixa Estrutura. Em seguida, escolha Criar.

  4. O Visual Studio cria o projeto e abre o arquivo de classe na janela do código, com o código a seguir. Se a linguagem que você quer usar não aparecer, altere o seletor de linguagem na parte superior da página.

    using Microsoft.VisualStudio.TestTools.UnitTesting;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Sub TestSub()

        End Sub
    End Class
End Namespace

    O código-fonte criado pelo modelo de teste de unidade faz o seguinte:

    Cada método marcado com [TestMethod] em uma classe de teste marcada com [TestClass] é executado automaticamente quando o teste de unidade é executado.

Adicionar uma referência ao projeto

Para que o projeto de teste funcione com a classe StringLibrary, adicione uma referência no projeto StringLibraryTest ao projeto StringLibrary.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó Dependências do projeto StringLibraryTest e selecione Adicionar Referência do Projeto no menu de contexto.

  2. Na caixa de diálogo Gerenciador de Referências, expanda o nó Projetos e selecione a caixa ao lado de StringLibrary. A adição de uma referência ao assembly StringLibrary permite que o compilador localize os métodos StringLibrary durante a compilação do projeto StringLibraryTest.

  3. Selecione OK.

Adicionar e executar métodos de teste de unidade

Quando o Visual Studio executa um teste de unidade, ele executa cada método marcado com o atributo TestMethodAttribute em uma classe marcada com o atributo TestClassAttribute. Um método de teste termina quando a primeira falha é encontrada ou quando todos os testes contidos no método têm êxito.

Os testes mais comuns chamam membros da classe Assert. Muitos métodos assert incluem pelo menos dois parâmetros, um deles é o resultado esperado do teste, e o outro é o resultado real do teste. Alguns dos métodos chamados com mais frequência da classe Assert são mostrados na tabela a seguir:

Métodos assert Função
Assert.AreEqual Verifica se os dois valores ou objetos são iguais. O assert falha se os valores ou objetos não forem iguais.
Assert.AreSame Verifica se duas variáveis de objeto se referem ao mesmo objeto. A assert falhará se as variáveis se referirem a objetos diferentes.
Assert.IsFalse Verifica se uma condição é false. O assert falhará se a condição for true.
Assert.IsNotNull Verifica se um objeto não é null. A assert falhará se o objeto for null.

Você também pode usar o método Assert.ThrowsException em um método de teste para indicar o tipo de exceção que ele deve gerar. O teste falhará se a exceção especificada não for lançada.

Ao testar o método StringLibrary.StartsWithUpper, você quer fornecer um número de cadeias de caracteres que comecem com um caractere maiúsculo. Você espera que o método retorne true nesses casos, para que possa chamar o método Assert.IsTrue. Da mesma forma, você deseja fornecer um número de cadeias de caracteres que comecem com algo diferente de um caractere maiúsculo. Você espera que o método retorne false nesses casos, para que possa chamar o método Assert.IsFalse.

Como seu método de biblioteca lida com cadeias de caracteres, convém ter certeza de que ele manipulará com êxito uma cadeia de caracteres vazia (String.Empty), uma cadeia de caracteres válida sem caracteres e cujo Length é 0 e uma cadeia de caracteres null que não foi inicializada. Você pode chamar StartsWithUpper diretamente como um método estático e passar um único argumento String. Ou você pode chamar StartsWithUpper como um método de extensão em uma variável string atribuída a null.

Você definirá três métodos, cada um deles chamará um método Assert para cada elemento em uma matriz de cadeia de caracteres. Você chamará uma sobrecarga de método que permite especificar uma mensagem de erro a ser exibida em caso de falha no teste. A mensagem identifica a cadeia de caracteres que causou a falha.

Para criar os métodos de teste:

  1. Na janela de código UnitTest1.cs ou UnitTest1.vb, substitua o código pelo seguinte:

    using Microsoft.VisualStudio.TestTools.UnitTesting;
using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public class UnitTest1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = { "Alphabet", "Zebra", "ABC", "Αθήνα", "Москва" };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result,
                       string.Format("Expected for '{0}': true; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = { "alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " " };
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word, result));
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = { string.Empty, null };
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result,
                       string.Format("Expected for '{0}': false; Actual: {1}",
                                     word == null ? "<null>" : word, result));
            }
        }
    }
}

    Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports UtilityLibraries

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Public Sub TestStartsWithUpper()
            ' Tests that we expect to return true.
            Dim words() As String = {"Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsTrue(result,
                       $"Expected for '{word}': true; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub TestDoesNotStartWithUpper()
            ' Tests that we expect to return false.
            Dim words() As String = {"alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " "}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsFalse(result,
                       $"Expected for '{word}': false; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub DirectCallWithNullOrEmpty()
            ' Tests that we expect to return false.
            Dim words() As String = {String.Empty, Nothing}
            For Each word In words
                Dim result As Boolean = StringLibrary.StartsWithUpper(word)
                Assert.IsFalse(result,
                       $"Expected for '{If(word Is Nothing, "<null>", word)}': false; Actual: {result}")
            Next
        End Sub
    End Class
End Namespace

    O teste de caracteres maiúsculos no método TestStartsWithUpper inclui a letra maiúscula grega alfa (U+0391) e a letra maiúscula cirílica EM (U+041C). O teste de caracteres minúsculos no método TestDoesNotStartWithUpper inclui a letra minúscula grega alfa (U+03B1) e a letra minúscula cirílica Ghe (U+0433).

  2. Na barra de menus, selecione Arquivo>Salvar UnitTest1.cs Como ou Arquivo>Salvar UnitTest1.vb Como. Na caixa de diálogo Salvar Arquivo Como, selecione a seta ao lado do botão Salvar e selecione Salvar com Codificação.

    Visual Studio Save File As dialog

  3. Na caixa de diálogo Confirmar Salvar Como, selecione o botão Sim para salvar o arquivo.

  4. Na caixa de diálogo Opções Avançadas de Salvamento, selecione Unicode (UTF-8 com assinatura) – página de código 65001 na lista suspensa Codificação e selecione OK.

    Visual Studio Advanced Save Options dialog

    Se você não salvar seu código-fonte como um arquivo codificado em UTF8, o Visual Studio poderá salvá-lo como um arquivo ASCII. Quando isso acontecer, o runtime não decodificará de forma precisa os caracteres UTF8 fora do intervalo ASCII e os resultados de teste não serão corretos.

  5. Na barra de menus, selecione Testar>Executar Todos os Testes. Se a janela do Gerenciador de Testes não abrir, abra-a escolhendo Teste>Gerenciador de Testes. Os três testes estão listados na seção Testes Aprovados, e a seção Resumo relata o resultado da execução de teste.

    Test Explorer window with passing tests

Identificar falhas de teste

Se você estiver fazendo o TDD (Desenvolvimento Orientado por Testes), você grava os testes primeiro e eles falharão na execução. Em seguida, você adiciona o código ao aplicativo que faz com que o teste seja bem-sucedido. Neste tutorial, você criou o teste depois de gravar o código do aplicativo que ele valida, portanto, você não viu o teste falhar. Para validar se um teste falha conforme o esperado, adicione um valor inválido à entrada de teste.

  1. Modifique a matriz words no método TestDoesNotStartWithUpper para incluir a cadeia de caracteres “Error”. Não é necessário salvar o arquivo porque o Visual Studio salva automaticamente os arquivos abertos quando uma solução é criada para executar testes.

    string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

    Dim words() As String = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " }

  2. Execute o teste selecionando Testar>Executar Todos os Testes na barra de menus. A Janela Gerenciador de Testes indica que dois testes tiveram êxito e um falhou.

    Test Explorer window with failing tests

  3. Selecione o teste com falha, TestDoesNotStartWith.

    A janela Gerenciador de Testes mostra a mensagem produzida pelo assert: "Assert.IsFalse falhou. Esperado para 'Error': false, real: True". Devido à falha, nenhuma cadeia de caracteres na matriz após "Error" foi testada.

    Test Explorer window showing the IsFalse assertion failure

  4. Remova a cadeia de caracteres "Error" que você adicionou na etapa 1. Execute novamente o teste, e ele será aprovado.

Testar a versão de lançamento da biblioteca

Agora que todos os nossos testes foram aprovados ao executar a compilação de Depuração da biblioteca, execute os testes mais uma vez na compilação de Lançamento da biblioteca. Vários fatores, incluindo as otimizações do compilador, podem produzir um comportamento diferente entre as compilações de Depuração e Lançamento.

Para testar a compilação de Lançamento:

  1. Na barra de ferramentas do Visual Studio, altere a configuração de compilação de Depurar para Lançamento.

    Visual Studio toolbar with release build highlighted

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto StringLibrary e selecione Compilar no menu de contexto para recompilar a biblioteca.

    StringLibrary context menu with build command

  3. Execute os testes de unidade escolhendo Testar>Executar todos os testes da barra de menu. Os testes são aprovados.

Depurar testes

Se você estiver usando o Visual Studio como seu IDE, será possível usar o mesmo processo mostrado no Tutorial: Depurar um aplicativo de console do .NET usando o Visual Studio para depurar o código usando seu projeto de teste de unidade. Em vez de iniciar o projeto do aplicativo ShowCase, clique com o botão direito do mouse no projeto StringLibraryTests e selecione Testes de Depuração no menu de contexto.

O Visual Studio inicia o projeto de teste com o depurador anexado. A execução será interrompida em qualquer ponto de interrupção adicionado ao projeto de teste ou ao código da biblioteca subjacente.

Recursos adicionais

Próximas etapas

Neste tutorial, você testou uma biblioteca de classes. Você pode disponibilizar a biblioteca para outras pessoas publicando-a no NuGet como um pacote. Para saber como, siga um tutorial do NuGet:

Criar e publicar um pacote NuGet usando o Visual Studio

Se você publicar uma biblioteca como um pacote NuGet, outras pessoas poderão instalá-la e usá-la. Para saber como, siga um tutorial do NuGet:

Instalar e usar um pacote no Visual Studio

Uma biblioteca não precisa ser distribuída como um pacote. Ela pode ser empacotada com um aplicativo de console que a usa. Para saber como publicar um aplicativo de console, consulte o tutorial anterior nesta série:

Publicar um aplicativo de console .NET usando o Visual Studio