Краткое руководство. Установка и использование пакета NuGet в Visual Studio (только Windows)

В этом кратком руководстве вы используете Microsoft Visual Studio для установки и использования пакета NuGet в проекте. Пакет NuGet содержит повторно используемый код, который другие разработчики предоставляют вам для использования в проектах.

Пакет NuGet можно установить в проекте Visual Studio с помощью NuGet Package Manager, Package Manager Console или .NET интерфейса командной строки (CLI). В этом кратком руководстве показано, как использовать Package Manager NuGet и консоль Package Manager для установки пакета. Выполните действия по созданию проекта Windows Presentation Foundation (WPF), использующего популярный пакет Newtonsoft.Json. Тот же процесс применяется к любому другому проекту .NET.

Эта статья предназначена только для Windows пользователей. Если вы используете Visual Studio для Mac, ознакомьтесь с Install и используйте пакет в Visual Studio для Mac.

Совет

Чтобы найти пакет NuGet, начните с nuget.org. Просмотр nuget.org заключается в том, как разработчики .NET обычно находят компоненты, которые они могут повторно использовать в своих приложениях. Вы можете выполнить поиск nuget.org напрямую или найти и установить пакеты в Visual Studio, как показано в этой статье. Дополнительные сведения см. в статье "Поиск и оценка пакетов NuGet" для проекта.

Необходимые условия

  • Установите Visual Studio 2026 с работой для разработки настольных приложений .NET.

    Вы можете установить выпуск Community 2026 бесплатно из visualstudio.microsoft.com или использовать выпуск Professional или Enterprise.

Создание проекта

Пакет NuGet можно установить в любой проект .NET, если этот пакет поддерживает ту же целевую платформу, что и проект. В этом кратком руководстве вы создадите проект приложения WPF.

Выполните следующие действия.

  1. В Visual Studio выберите File>New>Project/Solution.

  2. В окне создания проекта перейдите в поле поиска и введите wpf. В результирующем списке шаблонов проектов выберите шаблон WPF/c0> с тегами C# и Windows<>/c2> и выберите Next.

  3. В окне Configure your new project при необходимости обновите значения имени проекта и имени решения, после чего выберите Next.

  4. В окне Additional information в разделе Framework выберите .NET 10.0 (или последняя версия), а затем выберите Create.

    Visual Studio создает проект и отображается в Solution Explorer.

Добавьте пакет Newtonsoft.Json из NuGet

Чтобы установить пакет NuGet в этом быстром запуске, можно использовать NuGet Package Manager или Package Manager Console. В зависимости от формата проекта установка пакета NuGet записывает зависимость в файле проекта или в файле packages.config. Дополнительные сведения см. в рабочем процессе потребления пакетов .

Менеджер пакетов NuGet

Чтобы использовать NuGet Package Manager для установки пакета Newtonsoft.Json в Visual Studio выполните следующие действия:

  1. Выберите Project>Управление пакетами NuGet.

  2. На странице NuGet Package Manager рядом с источником Package выберите nuget.org.

  3. Перейдите на вкладку "Обзор" и найдите Newtonsoft.Json. В списке выберите Newtonsoft.Json и нажмите кнопку "Установить".

    Screenshot Package Manager NuGet. Выбран пакет Newtonsoft.Json. В области сведений отображаются данные пакета и есть кнопка

  4. Если вам будет предложено проверить установку, нажмите кнопку "Применить".

Консоль диспетчера пакетов

Кроме того, чтобы использовать консоль Package Manager в Visual Studio для установки пакета Newtonsoft.Json выполните следующие действия.

  1. В Visual Studio выберите Tools>NuGet Package Manager>Package Manager Console.

  2. В верхней части окна Консоль диспетчера пакетов убедитесь, что список 'Проект по умолчанию' указывает на проект, в котором вы хотите установить пакет. Если у вас есть один проект в решении, он автоматически выбран.

    Screenshot окна консоли Package Manager, содержащего сведения о версии и лицензировании. Список проектов по умолчанию выделен.

  3. В командной строке консоли введите команду Install-Package Newtonsoft.Json. Дополнительные сведения об этой команде см. в разделе Install-Package.

    В окне консоли отображаются выходные данные для команды. Ошибки обычно указывают на то, что пакет несовместим с целевой платформой проекта.

Использование API Newtonsoft.Json в приложении

После установки пакета NuGet вы можете сделать ссылку на него в коде с помощью using <namespace> инструкции, где <пространство> имен — это имя используемого пакета. После создания ссылки можно вызвать пакет через его API.

С помощью пакета Newtonsoft.Json в проекте можно вызвать его метод JsonConvert.SerializeObject. Чтобы использовать этот метод для преобразования объекта в удобочитаемую для человека строку, выполните следующие действия:

  1. В Solution Explorer откройте MainWindow.xaml и замените существующий элемент <Grid> следующим кодом:

    <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. В Solution Explorer разверните узел MainWindow.xaml и откройте файл MainWindow.xaml.cs. Вставьте следующий код внутри MainWindow класса после конструктора:

    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. Если MainWindow.xaml.cs не содержит следующую строку, добавьте ее в начало файла:

    using Newtonsoft.Json;

    Без этой строки Visual Studio помечает объект JsonConvert красной волнистой линией, чтобы указать на ошибку.

  4. Чтобы собрать и запустить приложение, выберите F5 или выберите Отладка>Запуск отладки.

    Откроется следующее окно:

    Скриншот окна MainWindow, которое приложение создает в Visual Studio. Окно содержит кнопку

  5. Выберите "Нажми на меня". Приложение обновляет окно, заменив TextBlock объект текстом JSON.

    Screenshot окна MainWindow в Visual Studio, который содержит кнопку click Me и код JSON, в котором перечислены идентификаторы, баланс и созданные значения.

Видео об использовании NuGet для управления пакетами см. в статье .NET Управление пакетами с помощью NuGet для начинающих и NuGet для начинающих.

Связанный контент

Дополнительные сведения об установке и управлении пакетами NuGet см. в следующих статьях:

Дополнительные сведения о NuGet см. в следующих статьях:

  • Last updated on