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

Neste início rápido, você usa Microsoft Visual Studio para instalar e usar um pacote NuGet em um projeto. 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 Visual Studio usando o NuGet Package Manager, o Package Manager Console ou a .NET interface de linha de comando (CLI). Este início rápido demonstra como usar o Package Manager do NuGet e o Console do Package Manager para instalar um pacote. Siga as etapas para criar um projeto de Windows Presentation Foundation (WPF) que usa o popular pacote Newtonsoft.Json. O mesmo processo se aplica a qualquer outro projeto de .NET.

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

Dica

Para localizar um pacote NuGet, comece com nuget.org. Procurar nuget.org é como .NET desenvolvedores 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 em Visual Studio conforme mostrado neste artigo. Para obter mais informações, consulte Localizar e avaliar pacotes NuGet para seu projeto.

Pré-requisitos

  • Instale o Visual Studio 2026 com o pacote de desenvolvimento para .NET desktop.

    Você pode instalar a edição 2026 community gratuitamente de visualstudio.microsoft.com ou pode usar a edição Professional ou Enterprise.

Criar um projeto

Você pode instalar um pacote NuGet em qualquer projeto .NET se esse pacote der suporte à mesma estrutura de destino que o projeto. Para este início rápido, você criará um projeto de aplicativo WPF.

Siga estas etapas:

  1. Em Visual Studio, selecione File>New>Project/Solution.

  2. Na janela Criar um novo projeto , vá para a caixa de pesquisa e insira o wpf. Na lista resultante de modelos de projeto, selecione o modelo WPF Application que tem marcas C# e Windows e selecione Next.

  3. No Configurar seu novo projeto, opcionalmente, atualize os valores de nome do projeto e nome da solução, e então selecione Próximo.

  4. Na janela Additional, em Framework, selecione .NET 10.0 (ou a versão mais recente) e selecione Create.

    Visual Studio cria o projeto e aparece em Solution Explorer.

Adicionar o pacote NuGet Newtonsoft.Json

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

Gerenciador de Pacotes NuGet

Para usar o NuGet Package Manager para instalar o pacote Newtonsoft.Json no Visual Studio, siga estas etapas:

  1. Selecione Project>Manage NuGet Packages.

  2. Na página NuGet Package Manager, ao lado da fonte Package, selecione nuget.org.

  3. Vá para a guia Procurar e procure Newtonsoft.Json. Na lista, selecione Newtonsoft.Json e, em seguida, selecione Instalar.

    Screenshot do Package Manager NuGet. O pacote Newtonsoft.Json está selecionado. Seu painel de detalhes exibe dados do pacote e tem um botão Instalar.

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

Console do Package Manager

Como alternativa, para usar o console Package Manager em Visual Studio para instalar o pacote Newtonsoft.Json, siga estas etapas:

  1. Em Visual Studio, selecione Tools>NuGet Package Manager>Package Manager Console.

  2. Na parte superior da janela Package Manager Console, verifique se a lista Default project mostra o projeto no qual você deseja instalar o pacote. Se você tiver um único projeto na solução, ele será pré-selecionado.

    Screenshot da janela do Console do Gerenciador de Pacotes, que contém informações sobre a versão e o licenciamento. A lista de projetos padrão é destacada.

  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 do console mostra a saída do comando. Os erros normalmente indicam que o pacote não é compatível com a estrutura de destino do projeto.

Usar a API Newtonsoft.Json no aplicativo

Depois de instalar um pacote NuGet, você pode fazer uma referência a ele em seu código usando a using <namespace> instrução, em <que o 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.

Com o pacote Newtonsoft.Json no projeto, você pode chamar o método JsonConvert.SerializeObject do pacote. Para usar esse método para converter um objeto em uma cadeia de caracteres legível por humanos, execute estas etapas:

  1. Em Solution Explorer, 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. Em Solution Explorer, expanda o nó MainWindow.xaml e abra o arquivo MainWindow.xaml.cs. Insira o seguinte código dentro da MainWindow classe, após o construtor:

    public class Account
{
    public string ID { get; set; }
    public decimal Balance { get; set; }
    public DateTime Created { get; set; }
}

private void Button_Click(object sender, RoutedEventArgs e)
{
    Account account = new Account
    {
        ID = "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u",
        Balance = 4389.21m,
        Created = new DateTime(2026, 4, 16, 0, 0, 0, DateTimeKind.Utc),
    };
    string json = JsonConvert.SerializeObject(account, Newtonsoft.Json.Formatting.Indented);
    TextBlock.Text = json;
}

  3. Se MainWindow.xaml.cs não contiver a seguinte linha, adicione-a ao início do arquivo:

    using Newtonsoft.Json;

    Sem essa linha, o Visual Studio marca o objeto JsonConvert com uma linha vermelha ondulada para indicar um erro.

  4. Para compilar e executar o aplicativo, selecione F5 ou selecione Depurar>Iniciar Depuração.

    A seguinte janela é exibida:

    Captura de tela da janela MainWindow que o aplicativo cria no Visual Studio. A janela contém um botão Clique Aqui e o termo TextBlock.

  5. Selecione Clique em Mim. O aplicativo atualiza a janela substituindo o TextBlock objeto pelo texto JSON.

    Screenshot da janela MainWindow no Visual Studio, que contém um botão Clique em Mim e código JSON que lista valores ID, Balance e Created.

Para obter vídeos sobre como usar o NuGet para gerenciamento de pacotes, consulte .NET Gerenciamento de Pacotes com NuGet para Iniciantes e NuGet para Iniciantes.

Conteúdo relacionado

Para saber mais sobre como instalar e gerenciar pacotes NuGet, confira os seguintes artigos:

  • Instalar e gerenciar pacotes em Visual Studio usando o Package Manager
  • Gerencie pacotes com o Visual Studio Package Manager Console (PowerShell)

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

  • Last updated on