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:
No Visual Studio, selecione Arquivo>Novo>Projeto.
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.
Na janela Configurar o seu novo projeto, opcionalmente, atualize o Nome do Projeto e o Nome da Soluçãoe, em seguida, selecione Avançar.
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:
Selecione projeto>Gerenciar pacotes NuGet.
Na página Gestor de Pacotes NuGet, escolha nuget.org como a Fonte do pacote.
Na guia Procurar, pesquise por Newtonsoft.Json, selecione Newtonsoft.Json na lista e, em seguida, selecione Instalar.
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:
No Visual Studio, selecione Ferramentas >Gestor de Pacotes NuGet>Consola do Gestor de Pacotes.
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.
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:
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>
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; }
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;
Para criar e executar a aplicação, pressione F5 ou selecione Depurar>Iniciar a Depuração.
É apresentada a seguinte janela:
Selecione o botão Click Me para ver o conteúdo do objeto
TextBlock
substituído por texto JSON.
Vídeo relacionado
Ver também
Para obter mais informações sobre o NuGet, consulte os seguintes artigos:
- O que é NuGet?
- Fluxo de trabalho de consumo de pacotes
- Encontrar e escolher pacotes
- Referências de pacotes em arquivos de projeto
- Instale e use um pacote usando a CLI do .NET.
- pacote Newtonsoft.Json
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.