NuGet 包包含其他开发人员提供的在项目中使用的可重用代码。 可以使用
NuGet 包管理器
、
包管理器控制台
或
.NET CLI
在 Microsoft Visual Studio 项目中安装 NuGet 包。 本文演示如何使用常用
Newtonsoft.Json
包创建Windows Presentation Foundation (WPF) 项目。 相同的过程适用于任何其他 .NET 或 .NET Core 项目。
安装 NuGet 包后,可以使用语句在代码
using <namespace>
中引用它,其中 <命名空间> 是正在使用的包的名称。 进行引用后,即可通过其 API 调用包。
本文仅适用于 Windows 用户。 如果使用的是 Visual Studio for Mac,请参阅
在 Visual Studio for Mac 中安装并使用包
。
nuget.org 入门
:为查找可在自己的应用程序中重用的组件,.NET 开发人员通常都会浏览 nuget.org 。 可以直接搜索 nuget.org 或根据本文中的介绍,在 Visual Studio 中查找和安装包 。 有关一般信息,请参阅
查找和评估 NuGet 包
。
使用 .NET 桌面开发工作负荷安装 Visual Studio 2022 for Windows。
可以从
visualstudio.com
免费安装 2019 Community 版,或者使用 Professional 或 Enterprise 版。
如果该包支持与项目相同的目标框架,则可以将 NuGet 包安装到任何 .NET 项目中。 但是,在本快速入门中,你将创建一个Windows Presentation Foundation (WPF) 应用程序项目。
请按照以下步骤操作:
在 Visual Studio 中,选择“文件”>“新建”>“项目”。
在“
创建新项目
”窗口中,在搜索框中输入
WPF
,然后在下拉列表中选择
C#
和
Windows
。 在模板列表中,选择“WPF 应用程序”,然后选择“下一步”。
在
“配置新项目
”窗口中,根据需要更新
项目名称和
解决方案名称
,然后选择“
下一步
”。
在
“其他信息
”窗口中,选择
.NET 6.0
(或适用于
框架
的最新版本) ,然后选择“
创建
”。
Visual Studio 将创建项目并在解决方案资源管理器中将其打开。
添加 Newtonsoft.Json Nuget 包
若要安装此包,可以使用 NuGet 包管理器或包管理器控制台。 根据项目格式,NuGet 包的安装记录项目文件或
packages.config
文件中的依赖项。 有关详细信息,请参阅
包使用概述和工作流
。
NuGet 程序包管理器
若要使用
NuGet 包管理器
在 Visual Studio 中安装
Newtonsoft.Json
包,请执行以下步骤:
选择“项目”>“管理 NuGet 包” 。
在“NuGet 包管理器”窗口中,选择“nuget.org”作为包源
。
在
“浏览
”选项卡中,搜索
Newtonsoft.Json
,在列表中选择
Newtonsoft.Json
,然后选择“
安装
”。
如果系统提示验证安装,请选择“
确定
”。
程序包管理器控制台
或者,若要使用 Visual Studio 中的
包管理器控制台
安装
Newtonsoft.Json
包,请执行以下步骤:
从 Visual Studio 中,依次选择“工具”>“NuGet 包管理器”>“包管理器控制台”
控制台打开后,检查 “默认项目”下拉列表中是否显示在程序包中要安装的项目。 如果在解决方案中有一个项目,则它已被选中。
在控制台提示符下,输入命令
Install-Package Newtonsoft.Json
。 有关 PowerShell 命令的详细信息,请参阅
Install-WindowsFeature
。
控制台窗口会显示该命令的输出。 错误通常指示程序包与项目的目标框架不兼容。
在应用中使用 Newtonsoft.Json API
使用项目中的 Newtonsoft.Json 包,可调用
Newtonsoft.Json
方法将对象转换为可人工读取的字符串。
在“解决方案资源管理器”中,打开 server.js 并将现有代码替换为以下代码:
<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>
在 MainWindow.xaml 节点下打开 MainWindow.xaml.cs 文件,并在构造函数之后在MainWindow
类中插入以下代码:
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;
若要避免代码中对象出现错误 JsonConvert
, (红色波浪线将出现) ,请在代码文件的开头添加以下语句:
using Newtonsoft.Json;
若要生成并运行应用,请按 F5 或选择“ 调试>开始调试”。
将显示以下窗口:
选择按钮,查看替换为某些 JSON 文本的 TextBlock 的内容:
通过 Visual Studio 安装和使用 NuGet 包
在第 9 频道和 YouTube 上查找更多 NuGet 视频。
若要深入了解分区,请参阅以下文章:
什么是 NuGet?
包使用工作流
查找和选择包
项目文件中的包引用
使用 .NET CLI 安装和使用包。
Newtonsoft.Json 包
祝贺你安装并使用第一个 NuGet 包! 转到下一篇文章,了解有关安装和管理 NuGet 包的详细信息。
使用 NuGet 包管理器安装和管理包
使用包管理器控制台安装和管理包