Partilhar via


Guia de 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 disponibilizaram para si para usar nos seus projetos. Você pode instalar um pacote NuGet em um projeto do Microsoft Visual Studio usando o do Gerenciador de Pacotes NuGet, o Console do Gerenciador de Pacotes ou o da CLI do .NET. Este artigo demonstra como criar um projeto do Windows Presentation Foundation (WPF) com o pacote Newtonsoft.Json popular. O mesmo processo se aplica a qualquer outro projeto .NET ou .NET Core.

Depois de instalar um pacote NuGet, você pode 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 de fazer uma referência, você pode chamar o pacote por meio de sua API.

O artigo é apenas para usuários do Windows. Se estiveres a usar o Visual Studio para Mac, consulta Instalar e usar um pacote no Visual Studio para Mac.

Dica

Para encontrar um pacote NuGet, comece com nuget.org. Navegar nuget.org é como os desenvolvedores do .NET normalmente encontram componentes que podem reutilizar em seus próprios aplicativos. Você pode fazer uma pesquisa de nuget.org diretamente ou localizar e instalar pacotes no Visual Studio, conforme mostrado neste artigo. Para obter mais informações, consulte Localizar e avaliar pacotes NuGet.

Pré-requisitos

  • Instale o Visual Studio 2022 para Windows com o workload de desenvolvimento para desktop .NET.

    Você pode instalar a edição Community 2022 gratuitamente a partir do visualstudio.microsoft.comou usar a edição Professional ou Enterprise.

Criar um projeto

Você pode instalar um pacote NuGet em qualquer projeto .NET se esse pacote oferecer suporte à mesma estrutura de destino do projeto. No entanto, para este início rápido, você criará um projeto de aplicativo do Windows Presentation Foundation (WPF).

Siga estes passos:

  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 WPF Applicatione, em seguida, selecione Next.

  3. Na janela Configurar o seu novo projeto, opcionalmente, atualize o Nome do Projeto e o Nome da Soluçãoe, em seguida, selecione Avançar.

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

    Visual Studio cria o projeto e ele aparece em Gerenciador de Soluções.

Adicione o pacote Newtonsoft.Json NuGet

Para instalar um pacote 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 Processo de consumo de pacotes.

Gerenciador de Pacotes NuGet

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

  1. Selecione projeto>Gerenciar pacotes NuGet.

  2. Na página Gestor de Pacotes NuGet, escolha nuget.org como a Fonte do pacote.

  3. Na guia Procurar, pesquise por Newtonsoft.Json, selecione Newtonsoft.Json na lista e, em seguida, selecione Instalar.

    Captura de tela mostrando a janela do Gerenciador de Pacotes NuGet com o pacote Newtonsoft.Json selecionado.

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

Console do Gestor de Pacotes

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

  1. No Visual Studio, selecione Ferramentas >Gestor de Pacotes NuGet>Consola do Gestor de Pacotes.

  2. Depois que o painel Console do Gerenciador de Pacotes abrir, verifique se a lista suspensa de projeto padrão mostra o projeto no qual você deseja instalar o pacote. Se você tiver um único projeto na solução, ele será pré-selecionado.

    Captura de tela mostrando a janela Package Manage Console com o projeto Default realçado.

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

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

Utilize a API Newtonsoft.Json na aplicação

Com o pacote Newtonsoft.Json no projeto, chame seu método JsonConvert.SerializeObject para converter um objeto em uma cadeia de caracteres legível por humanos:

  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 sob o 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 encaixe vermelha aparecerá), adicione a seguinte instrução no início do arquivo de código:

    using Newtonsoft.Json;
    
  4. Para criar e executar a aplicação, pressione F5 ou selecione Depurar>Iniciar a Depuração.

    É apresentada a seguinte janela:

    Captura de tela mostrando a saída inicial do aplicativo WPF.

  5. Selecione o botão Click Me para ver o conteúdo do objeto TextBlock substituído por texto JSON.

    Captura de tela mostrando a saída do aplicativo WPF depois de selecionar o botão.

Ver também

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

Próximos passos

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.