Compartilhar via

Tutorial: Criar uma biblioteca de classes do .NET usando o Visual Studio Code

  • Artigo

Neste tutorial, você criará uma biblioteca de utilitários simples que contém um único método de tratamento de cadeia de caracteres.

Uma biblioteca de classes define tipos e métodos que são chamados por um aplicativo. Se a biblioteca for direcionada ao .NET Standard 2.0, ela poderá ser chamada por qualquer implementação do .NET (incluindo o .NET Framework) que dê suporte ao .NET Standard 2.0. Se a biblioteca for direcionada ao .NET 9, ela poderá ser chamada por qualquer aplicativo direcionado ao .NET 9. Este tutorial mostra como fazer o direcionamento para o .NET 9.

Ao criar uma biblioteca de classes, você pode distribuí-la como um componente de terceiros ou como um componente agrupado com um ou mais aplicativos.

Pré-requisitos

Criar um projeto de biblioteca de classes

Comece criando um projeto de biblioteca de classes do .NET chamado "StringLibrary" e uma solução associada. Uma solução serve como um contêiner para um ou mais projetos. Você adicionará projetos adicionais relacionados à mesma solução.

  1. Inicie o Visual Studio Code.

  2. Vá para a visão do Explorer e selecione Criar Projeto .NET. Como alternativa, você pode abrir a Paleta de Comandos usando Ctrl+Shift+P (Command+Shift+P no MacOS) e, em seguida, digitar ".NET" e localizar e selecionar o comando .NET: Novo Projeto.

  3. Depois de selecionar o comando, você precisará escolher o modelo de projeto. Escolha Biblioteca de Classes.

  4. Em seguida, selecione o local onde você deseja que o novo projeto seja criado.

  5. Em seguida, selecione o local onde você deseja que o novo projeto seja criado: crie uma pasta chamada ClassLibraryProjects e selecione-a.

  6. Nomeie o projeto StringLibrary, selecione Mostrar todas as opções de modelo, selecione .NET 9 e selecione Criar Projeto.

  7. Nomeie o projeto StringLibrary e selecione Criar Projeto.

  8. Pressione Enter quando solicitado, o projeto será criado no diretório <>.

  9. Verifique se a biblioteca tem como destino o .NET 9. Abra o Explorere em seguida abra StringLibrary/StringLibrary.csproj.

    O elemento TargetFramework mostra que o projeto tem como destino o .NET 9.0.

    <Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>

  10. Abra Class1.cs e substitua o código pelo código a seguir.

    using System;

namespace UtilityLibraries
{
    public static class StringLibrary
    {
        public static bool StartsWithUpper(this string str)
        {
            if (string.IsNullOrWhiteSpace(str))
                return false;

            char ch = str[0];
            return char.IsUpper(ch);
        }
    }
}

    A biblioteca de classes, UtilityLibraries.StringLibrary, contém um método chamado StartsWithUpper. Esse método retorna um valor Boolean que indica se a instância de cadeia de caracteres atual começa com um caractere maiúsculo. O padrão Unicode distingue caracteres maiúsculos de caracteres minúsculos. O método Char.IsUpper(Char) retornará true se um caractere for maiúsculo.

    StartsWithUpper é implementado como um método de extensão para que você possa chamá-lo como se fosse um membro da classe String.

  11. Salve o arquivo.

  12. Expanda Gerenciador de Soluções na parte inferior da visualização do Explorer.

  13. Clique com o botão direito do mouse na solução no do Gerenciador de Soluções e selecione Criarou abra a Paleta de Comandos e selecione .NET: Criar para criar a solução e verificar se o projeto é compilado sem erros.

    A saída do terminal se parece com o exemplo a seguir:

    Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
Build succeeded.
    0 Warning(s)
    0 Error(s)
Time Elapsed 00:00:02.78

Adicionar um aplicativo de console à solução

Adicione um aplicativo de console que usa a biblioteca de classes. O aplicativo solicitará que o usuário insira uma cadeia de caracteres e relate se a cadeia de caracteres começa com um caractere maiúsculo.

  1. Clique com o botão direito do mouse na solução no do Gerenciador de Soluções e selecione Novo Projetoou, na Paleta de Comandos, selecione .NET: Novo Projeto.

  2. Selecione o aplicativo Console.

  3. Dê o nome ShowCase, selecione o local padrão e selecione Criar Projeto.

  4. Abra ShowCase/Program.cs e substitua todo o código pelo código a seguir.

    using System;
using UtilityLibraries;

class Program
{
    static void Main(string[] args)
    {
        int row = 0;

        do
        {
            if (row == 0 || row >= 25)
                ResetConsole();

            string? input = Console.ReadLine();
            if (string.IsNullOrEmpty(input)) break;
            Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                              $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
            row += 3;
        } while (true);
        return;

        // Declare a ResetConsole local method
        void ResetConsole()
        {
            if (row > 0)
            {
                Console.WriteLine("Press any key to continue...");
                Console.ReadKey();
            }
            Console.Clear();
            Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
            row = 3;
        }
    }
}

    O código usa a variável row para manter uma contagem do número de linhas de dados gravadas na janela do console. Sempre que for maior ou igual a 25, o código limpa a janela do console e exibe uma mensagem para o usuário.

    O programa solicita que o usuário insira uma cadeia de caracteres. Indica se a cadeia de caracteres começa com um caractere maiúsculo. Se o usuário pressionar o Enter tecla sem inserir uma cadeia de caracteres, o aplicativo terminará e a janela do console será fechada.

  5. Salve suas alterações.

Adicionar uma referência de projeto

Inicialmente, o novo projeto de aplicativo de console não tem acesso à biblioteca de classes. Para permitir que ele chame métodos na biblioteca de classes, crie uma referência de projeto para o projeto de biblioteca de classes.

  1. No Gerenciador de Soluções clique com o botão direito do mouse no projeto ShowCase e selecione Adicionar Referência do Projeto.

  2. Selecione StringLibrary.

Executar o aplicativo

  1. Selecione Executar>Executar sem depurar.

  2. Selecione C#.

  3. Selecione ShowCase.

    Se você receber um erro informando que nenhum programa C# está carregado, feche a pasta que você abriu e abra a pasta ShowCase. Em seguida, tente executar o aplicativo novamente.

  4. Experimente o programa inserindo cadeias de caracteres e pressionando Entere pressione Enter para sair.

    A saída do terminal se parece com o exemplo a seguir:

    Press <Enter> only to exit; otherwise, enter a string and press <Enter>:

A string that starts with an uppercase letter
Input: A string that starts with an uppercase letter
Begins with uppercase? : Yes

a string that starts with a lowercase letter
Input: a string that starts with a lowercase letter
Begins with uppercase? : No

Recursos adicionais

Próximas etapas

Neste tutorial, você criou um projeto de biblioteca e adicionou um projeto de aplicativo de console que usa a biblioteca. No próximo tutorial, você adicionará um projeto de teste de unidade à solução.

Testar uma biblioteca de classes do .NET usando o Visual Studio Code