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

  • Artigo

Um pacote NuGet contém código reutilizável que outros desenvolvedores disponibilizaram 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 de Windows Presentation Foundation (WPF) com o pacote popularNewtonsoft.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 no código com a using <namespace> instrução, onde <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.

O artigo é somente para usuários do Windows. Se você estiver usando Visual Studio para Mac, consulte Instalar e usar um pacote em 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 a carga de trabalho de desenvolvimento da área de trabalho do .NET.

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

Criar um projeto

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

Siga estas etapas:

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

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

  3. Na janela Configurar seu novo projeto , atualize opcionalmente 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) para o Framework e selecione Criar.

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

Adicionar o pacote do NuGet Newtonsoft.Json

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 Fluxo de trabalho de consumo de pacote.

Gerenciador de Pacotes NuGet

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

  1. Selecione Projeto>Gerenciar Pacotes do NuGet.

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

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

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

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

Console do Gerenciador de Pacotes

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

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

  2. Depois que o painel console do Gerenciador de Pacotes for aberto, verifique se a lista suspensa padrão do projeto 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 Gerenciar Pacote do Console com o projeto Padrão realçado.

  3. No prompt do console, insira 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 para o 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 Newtonsoft.Json pacote no projeto, chame seu JsonConvert.SerializeObject método para converter um objeto em uma cadeia de caracteres legível por humanos:

  1. Em Gerenciador 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. Abra o arquivo MainWindow.xaml.cs no nó MainWindow.xaml e insira o seguinte código dentro da MainWindow classe 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 JsonConvert objeto no código (uma linha de rabiscos vermelho será exibida), adicione a seguinte instrução no início do arquivo de código:

    using Newtonsoft.Json;

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

    A seguinte janela é exibida:

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

  5. Selecione o botão Clique em Mim para ver o conteúdo do TextBlock objeto substituído pelo texto JSON.

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

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.

Instalar e gerenciar pacotes usando o Gerenciador de Pacotes Do NuGet

Instalar e gerenciar pacotes usando o Console do Gerenciador de Pacotes