Compartilhar via


Início Rápido: Instalar e usar um pacote NuGet no Visual Studio (somente Windows)

Um pacote NuGet contém código reutilizável que outros desenvolvedores disponibilizam para uso em seus projetos. Você pode instalar um pacote NuGet em um projeto do Microsoft Visual Studio usando o Gerenciador de Pacotes NuGet, o Console do Gerenciador de Pacotes ou a CLI do .NET. Este artigo demonstra como criar um projeto do Windows Presentation Foundation (WPF) com o popular pacote Newtonsoft.Json. O mesmo processo se aplica a qualquer outro projeto .NET ou .NET Core.

Depois de instalar um pacote NuGet, você poderá fazer uma referência a ele em seu código com a instrução using <namespace>, onde <namespace> é o nome do pacote que você está usando. Depois que a referência for feita, você poderá chamar o pacote por meio de sua API.

O artigo destina-se apenas a usuários do Windows. Se você estiver usando o Visual Studio para Mac, consulte Instalar e usar um pacote no Visual Studio para Mac.

Dica

Para encontrar um pacote NuGet, comece com nuget.org: navegar em nuget.org é como os desenvolvedores em .NET costumam encontrar os componentes que podem reutilizar em seus próprios aplicativos. Você pode pesquisar em nuget.org diretamente ou localizar e instalar pacotes de dentro do Visual Studio, conforme mostrado neste artigo. Para obter mais informações, consulte Procurar e avaliar pacotes NuGet.

Pré-requisitos

  • Instale o Visual Studio 2022 para Windows com a carga de trabalho de desenvolvimento para desktop do .NET

    É possível instalar a edição Community 2022 gratuitamente em visualstudio.microsoft.com ou usar a edição Professional ou Enterprise.

Criar um projeto

É possível instalar um pacote do NuGet em qualquer projeto .NET desde que o pacote ofereça suporte à mesma estrutura de destino que o projeto. No entanto, para este início rápido, você criará um aplicativo do WPF (Windows Presentation Foundation).

Siga estas etapas:

  1. No Visual Studio, selecione Arquivo>Novo>Projeto.

  2. Na janela Criar um novo projeto, digite WPF na caixa de pesquisa e selecione C# e Windows nas listas suspensas. Na lista resultante de modelos de projeto, selecione Aplicativo WPF e, em seguida, selecione Avançar.

  3. Na janela Configurar seu novo projeto, opcionalmente, atualize o Nome do projeto e o Nome da solução e selecione Avançar.

  4. Na janela Informações adicionais, selecione .NET 6.0 (ou a versão mais recente) como Estrutura e, em seguida, selecione Criar.

    O Visual Studio cria e abre o projeto no Gerenciador de Soluções.

Adicionar o pacote do NuGet Newtonsoft.Json

Para instalar um pacote do NuGet, neste início rápido, você pode usar o Gerenciador de Pacotes NuGet ou o Console do Gerenciador de Pacotes. Dependendo do formato do projeto, a instalação de um pacote NuGet registra a dependência no arquivo de projeto ou em um arquivo packages.config. Para obter mais informações, consulte Fluxo de trabalho do consumo de pacotes.

Gerenciador de Pacotes NuGet

Para usar o Gerenciador de Pacotes NuGet para instalar o pacote Newtonsoft.Json no Visual Studio, siga estas etapas:

  1. Selecione Projeto>Gerenciar Pacotes do NuGet.

  2. Na página Gerenciador de Pacotes do NuGet, selecione nuget.org como a Origem do pacote.

  3. Na guia Procurar, procure Newtonsoft.Json, selecione Newtonsoft.Json na lista e selecione Instalar.

    Screenshot showing the NuGet Package Manager window with the Newtonsoft.Json package selected.

  4. Se for solicitado que você verifique a instalação, selecione OK.

Console do Gerenciador de Pacotes

Para usar o Console do Gerenciador de Pacotes no Visual Studio para instalar o pacote Newtonsoft.Json, siga estas etapas:

  1. No Visual Studio, selecione Ferramentas>Gerenciador de Pacotes NuGet>Console do Gerenciador de Pacotes

  2. Após o painel Console do Package Manager abrir, verifique se a lista suspensa Projeto padrão mostra o projeto no qual você deseja instalar o pacote. Se você tiver um único projeto na solução, ele estará pré-selecionado.

    Screenshot showing the Package Manage Console window with Default project highlighted.

  3. No prompt do console, insira o comando Install-Package Newtonsoft.Json. Para obter mais informações sobre esse comando, consulte Instalar pacote.

    A janela do console mostra a saída do comando. Os erros indicam que o pacote não é compatível com a estrutura de destino do projeto.

Use a API Newtonsoft.Json no aplicativo

Com o pacote Newtonsoft.Json no projeto, chame seu método JsonConvert.SerializeObject para converter um objeto em uma sequência legível por pessoas:

  1. No Gerenciador de Soluções, abra MainWindow.xaml e substitua o elemento <Grid> existente pelo seguinte código:

    <Grid Background="White">
        <StackPanel VerticalAlignment="Center">
            <Button Click="Button_Click" Width="100px" HorizontalAlignment="Center" Content="Click Me" Margin="10"/>
            <TextBlock Name="TextBlock" HorizontalAlignment="Center" Text="TextBlock" Margin="10"/>
        </StackPanel>
    </Grid>
    
  2. Abra o arquivo MainWindow.xaml.cs no nó MainWindow.xaml e insira o seguinte código dentro da classe MainWindow após o construtor:

    public class Account
    {
        public string Name { get; set; }
        public string Email { get; set; }
        public DateTime DOB { get; set; }
    }
    
    private void Button_Click(object sender, RoutedEventArgs e)
    {
        Account account = new Account
        {
            Name = "John Doe",
            Email = "john@microsoft.com",
            DOB = new DateTime(1980, 2, 20, 0, 0, 0, DateTimeKind.Utc),
        };
        string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
        TextBlock.Text = json;
    }
    
  3. Para evitar um erro para o objeto JsonConvert no código (uma linha de texto sublinhado vermelha aparecerá), adicione a seguinte instrução no início do arquivo de código:

    using Newtonsoft.Json;
    
  4. Para compilar e executar o aplicativo, pressione F5 ou selecione Depurar>Iniciar depuração.

    A seguinte janela é exibida:

    Screenshot showing the initial output of the WPF app.

  5. Selecione o botão Clique em mim para ver o conteúdo do objeto TextBlock substituído com algum texto JSON:

    Screenshot showing the output of the WPF app after selecting the button.

Confira também

Para obter mais informações sobre o NuGet, consulte os seguintes artigos:

Próximas etapas

Parabéns por instalar e usar seu primeiro pacote NuGet. Avance para o próximo artigo para saber mais sobre como instalar e gerenciar pacotes NuGet.