Partilhar via

Início rápido: Instale e use um pacote NuGet no Visual Studio (apenas para Windows)

Neste quickstart, usas Microsoft Visual Studio para instalar e usar um pacote NuGet num projeto. Um pacote NuGet contém código reutilizável que outros programadores disponibilizam para usar nos seus projetos.

Pode instalar um pacote NuGet num projeto do Visual Studio usando o Gestor de Pacotes NuGet, a Consola do Gestor de Pacotes ou a interface de linha de comandos (CLI) .NET. Este quickstart demonstra como usar o NuGet Gestor de Pacotes e a Gestor de Pacotes Console para instalar um pacote. Segue os passos para criar um projeto Windows Presentation Foundation (WPF) que utilize o popular pacote Newtonsoft.Json. O mesmo processo aplica-se a qualquer outro projeto .NET.

Este artigo destina-se apenas a utilizadores de 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 por nuget.org. Navegar nuget.org é como .NET programadores normalmente encontram componentes que podem reutilizar nas suas próprias aplicações. Pode pesquisar diretamente nuget.org ou encontrar e instalar pacotes dentro de Visual Studio, como mostrado neste artigo. Para mais informações, consulte Encontrar e avaliar pacotes NuGet para o seu projeto.

Pré-requisitos

  • Instale o Visual Studio 2026 com a carga de trabalho de desenvolvimento desktop .NET.

    Pode instalar a edição Community 2026 gratuitamente a partir do visualstudio.microsoft.com, ou optar pela edição Professional ou Enterprise.

Criar um projeto

Pode instalar um pacote NuGet em qualquer projeto .NET se esse pacote suportar o mesmo framework alvo que o projeto. Para este início rápido, você criará um projeto de aplicação WPF.

Siga estes passos:

  1. No Visual Studio, selecione File>Novo>Project/Solution.

  2. Na janela Criar um novo projeto , vá à caixa de pesquisa e introduza wpf. Na lista resultante de modelos de projeto, selecione o modelo WPF Application que tenha as etiquetas C# e Windows, e depois selecione Next.

  3. Na janela Configure o seu novo projeto, atualize opcionalmente os valores Nome do projeto e Nome da solução, e depois selecione Seguinte.

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

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

Adicione o pacote Newtonsoft.Json NuGet

Para instalar um pacote NuGet neste guia de início rápido, pode usar tanto o Gestor de Pacotes NuGet como a Consola do Gestor 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.

Gestor de Pacotes NuGet

Para usar o NuGet Gestor de Pacotes para instalar o pacote Newtonsoft.Json no Visual Studio, siga estes passos:

  1. Selecione Project>Gerir Pacotes NuGet.

  2. Na página NuGet Gestor de Pacotes, ao lado de Package source, selecione nuget.org.

  3. Vai ao separador Explorar e procure por Newtonsoft.Json. Na lista, selecione Newtonsoft.Json e depois selecione Instalar.

    Captura de ecrã do Gestor de Pacotes NuGet. O pacote Newtonsoft.Json é selecionado. O seu painel de detalhes mostra os dados do pacote e tem um botão de Instalar.

  4. Se lhe pedirem para verificar a instalação, selecione Aplicar.

Consola do Gestor de Pacotes

Alternativamente, para usar a Consola Gestor de Pacotes em Visual Studio instalar o pacote Newtonsoft.Json, siga estes passos:

  1. No Visual Studio, selecione Tools>NuGet Gestor de Pacotes>Gestor de Pacotes Console.

  2. No topo da janela Gestor de Pacotes Console, verifica se a lista Projeto Padrão mostra o projeto onde queres instalar o pacote. Se você tiver um único projeto na solução, ele será pré-selecionado.

    Captura de ecrã da janela Gestor de Pacotes Consola, que contém informações sobre a versão e licenciamento. A lista de projetos padrão está 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 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

Depois de instalar um pacote NuGet, pode fazer referência a ele no seu código usando a using <namespace> instrução, onde <namespace> é o nome do pacote que está a usar. Depois de fazeres uma referência, podes chamar o pacote através da sua API.

Com o pacote Newtonsoft.Json no projeto, pode chamar o método JsonConvert.SerializeObject. Para usar este método para converter um objeto numa cadeia legível por humanos, siga estes passos:

  1. Em Explorador de Soluções, abra MainWindow.xaml e substitua o elemento existente <Grid> 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 Explorador de Soluções, expanda o nó MainWindow.xaml e depois abra o ficheiro 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 ficheiro:

    using Newtonsoft.Json;

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

  4. Para construir e executar a aplicação, selecione F5 ou selecione Depurar>Iniciar Depuração.

    É apresentada a seguinte janela:

    Captura de ecrã da janela MainWindow que a aplicação cria em Visual Studio. A janela contém um botão Click Me e o termo TextBlock.

  5. Selecione Clique Aqui. A aplicação atualiza a janela substituindo o TextBlock objeto por texto JSON.

    Captura de ecrã da janela MainWindow em Visual Studio, que contém um botão Click Me e código JSON que lista ID, Balance e valores Criados.

Para vídeos sobre o uso do NuGet para gestão de pacotes, veja .NET Gestão de Pacotes com NuGet para Iniciantes e NuGet para Iniciantes.

Conteúdo relacionado

Para saber mais sobre a instalação e gestão de pacotes NuGet, consulte os seguintes artigos:

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

  • Last updated on