Criar uma biblioteca de .NET Standard no Visual StudioBuild a .NET Standard library in Visual Studio

Uma biblioteca de classes define tipos e métodos que são chamados por um aplicativo.A class library defines types and methods that are called by an application. Uma biblioteca de classes que tem como alvo .NET Standard 2,0 permite que sua biblioteca seja chamada por qualquer implementação do .NET que dê suporte a essa versão do .NET Standard.A class library that targets .NET Standard 2.0 allows your library to be called by any .NET implementation that supports that version of .NET Standard. Quando você finaliza sua biblioteca de classes, pode decidir se deseja distribuí-la como um componente de terceiros ou se quer incluí-la como um componente agrupado com um ou mais aplicativos.When you finish your class library, you can decide whether you want to distribute it as a third-party component or whether you want to include it as a bundled component with one or more applications.

Observação

Para obter uma lista de versões de .NET Standard e as plataformas às quais eles dão suporte, consulte .net Standard.For a list of .NET Standard versions and the platforms they support, see .NET Standard.

Neste tópico, você criará uma biblioteca de utilitários simples que contém um único método de manipulação de cadeia de caracteres.In this topic, you'll create a simple utility library that contains a single string-handling method. Você implementará essa biblioteca como um método de extensão, para que você possa chamá-la como se fosse membro da classe String.You'll implement it as an extension method so that you can call it as if it were a member of the String class.

Criar uma solução do Visual StudioCreate a Visual Studio solution

Comece criando uma solução em branco para colocar o projeto de biblioteca de classes no.Start by creating a blank solution to put the class library project in. Uma solução do Visual Studio serve como um contêiner para um ou mais projetos.A Visual Studio solution serves as a container for one or more projects. Você adicionará mais projetos relacionados à mesma solução se continuar com a série de tutoriais.You'll add additional, related projects to the same solution if you continue on with the tutorial series.

Para criar a solução em branco:To create the blank solution:

  1. {1>Abra o Visual Studio.<1}Open Visual Studio.

  2. Na tela Iniciar, selecione Criar um novo projeto.On the start window, choose Create a new project.

  3. Na página criar um novo projeto , digite solução na caixa de pesquisa.On the Create a new project page, enter solution in the search box. Escolha o modelo de solução em branco e, em seguida, escolha Avançar.Choose the Blank Solution template, and then choose Next.

    Modelo de solução em branco no Visual Studio

  4. Na página configurar seu novo projeto , digite ClassLibraryProjects na caixa nome do projeto .On the Configure your new project page, enter ClassLibraryProjects in the Project name box. Em seguida, escolha Criar.Then, choose Create.

Dica

Você também pode ignorar esta etapa e deixar que o Visual Studio crie a solução para você ao criar o projeto na próxima etapa.You can also skip this step and let Visual Studio create the solution for you when you create the project in the next step. Procure as opções de solução na página configurar seu novo projeto .Look for the solution options on the Configure your new project page.

Criar um projeto de biblioteca de classesCreate a class library project

  1. Adicione um novo C# projeto de biblioteca de classe .net Standard chamado "StringLibrary" à solução.Add a new C# .NET Standard class library project named "StringLibrary" to the solution.

    1. Clique com o botão direito do mouse na solução em Gerenciador de soluções e selecione Adicionar > novo projeto.Right-click on the solution in Solution Explorer and select Add > New project.

    2. Na página Adicionar um novo projeto , insira biblioteca na caixa de pesquisa.On the Add a new project page, enter library in the search box. Escolha C# na lista idioma e, em seguida, escolha todas as plataformas na lista plataforma.Choose C# from the Language list, and then choose All platforms from the Platform list. Escolha o modelo biblioteca de classes (.net Standard) e, em seguida, escolha Avançar.Choose the Class Library (.NET Standard) template, and then choose Next.

    3. Na página configurar seu novo projeto , digite StringLibrary na caixa nome do projeto .On the Configure your new project page, enter StringLibrary in the Project name box. Em seguida, escolha Criar.Then, choose Create.

  2. Verifique se a biblioteca tem como destino a versão correta do .NET Standard.Check to make sure that the library targets the correct version of .NET Standard. Clique com o botão direito do mouse no projeto de biblioteca em Gerenciador de soluçõese selecione Propriedades.Right-click on the library project in Solution Explorer, and then select Properties. A caixa de texto estrutura de destino mostra que o projeto tem como destino .net Standard 2,0.The Target Framework text box shows that the project targets .NET Standard 2.0.

    Propriedades do projeto da biblioteca de classes

  3. Substitua o código na janela de código pelo mostrado a seguir e salve o arquivo:Replace the code in the code window with the following code and save the file:

    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.The class library, UtilityLibraries.StringLibrary, contains a method named StartsWithUpper. Esse método retorna um valor Boolean que indica se a instância da cadeia de caracteres atual começa com um caractere maiúsculo.This method returns a Boolean value that indicates whether the current string instance begins with an uppercase character. O padrão Unicode distingue caracteres maiúsculos de caracteres minúsculos.The Unicode standard distinguishes uppercase characters from lowercase characters. O método Char.IsUpper(Char) retornará true se um caractere for maiúsculo.The Char.IsUpper(Char) method returns true if a character is uppercase.

  4. Na barra de menus, selecione Compilar > Compilar Solução.On the menu bar, select Build > Build Solution.

O projeto deve ser compilado sem erros.The project should compile without error.

{1>{2>Próximas etapas<2}<1}Next steps

Você compilou com êxito a biblioteca.You've successfully built the library. Mas como você ainda não chamou nenhum de seus métodos, não sabe se ele funciona como esperado.Because you haven't called any of its methods, you don't know whether it works as expected. A próxima etapa no desenvolvimento da biblioteca é testá-la.The next step in developing your library is to test it.