首页 | 编程 | ASP.NET

.NET Core中创建和使用NuGet包的示例代码

2020年04月03日 作者：PowerCoder原文

在.NET Core的项目中，如果我们要在项目中引用其它DLL文件，不建议直接在项目引用中添加DLL文件（虽然在.NET Core项目中也可以这么做），建议是去直接下载DLL文件所属的NuGet包。这样最大的好处是我们可以将要引用DLL文件的所有依赖文件也一起引入到项目中，这样保证了引用文件的完整性，让其可以正确地运行。

下面我们通过一个.NET Core类库项目和一个ASP.NET Core项目，来演示怎么发布一个NuGet包，并在项目中引用该NuGet包。

首先我们新建一个.NET Core类库项目"Custom.Library.StringUtils"，它包含一个简单的字符串工具类"StringHelper"，用来做简单的字符串处理：

using System;
using Newtonsoft.Json;

namespace Custom.Library.StringUtils
{
 /// <summary>
 /// 字符串工具类
 /// </summary>
 public static class StringHelper
 {
  /// <summary>
  /// 将字符串转换为大写
  /// </summary>
  /// <param name="text">字符串</param>
  /// <returns>大写的字符串</returns>
  public static string GetUpperString(string text)
  {
   return text.ToUpper();
  }

  /// <summary>
  /// 将一个对象转换为json字符串
  /// </summary>
  /// <param name="jsonObject">对象</param>
  /// <returns>json字符串</returns>
  public static string ToJson(object jsonObject)
  {
   return JsonConvert.SerializeObject(jsonObject);
  }
 }
}

注意为了演示我们这个.NET Core类库项目还引用了其它NuGet包，我们在项目中引用和使用了著名的json处理NuGet包：Newtonsoft.Json

在项目的属性上，我们选中Build页面，这里有两个地方要进行设置，首先由于我们是要在发布的NuGet包中生成XMLdocumentation文件，来包含<summary>注释，所以我们要将Configuration下拉框选择为All Configurations，这样我们可以在发布（Release）时也生成XMLdocumentation文件，而不仅仅是在调试（Debug）时才生成。然后我们还要确保XML documentation file这个复选框是勾上的，这样当我们的.NET Core类库项目发布后才会生成对应的XML documentation文件：

然后我们就可以发布我们的.NET Core类库项目"Custom.Library.StringUtils"为NuGet包了，在项目上点击发布（Publish）：

点击发布（Publish）后，我们可以在目录"C:\Local nuget repository"下看到，类库项目生成的NuGet文件就已经存在了：

然后再发布.NET Core类库项目，我们可以看到在发布目录"C:\Local nuget repository"下会再生成一个NuGet文件，这次版本号是2.0.0：

然后在弹出窗口中选中Package Sources页面，然后点击加号新建一个NuGet包source，名称（Name）为"Local nuget package"，路径（Source）为我们前面.NET Core类库项目的发布目录"C:\Local nuget repository"，如下所示：

然后，我们将右上角的Package source下拉框选择为All，接着在搜索框中输入我们前面发布的.NET Core类库项目名"Custom.Library.StringUtils"，就可以找到我们发布的NuGet包了，由于我们前面发布了两个版本到发布目录"C:\Local nuget repository"，所以这里显示NuGet包的版本也有两个"1.0.0"和"2.0.0"，另外由于我们在.NET Core类库项目"Custom.Library.StringUtils"中引用了Newtonsoft.Json这个NuGet包，所以我们这里看到在Dependencies下面显示我们的NuGet包还依赖于Newtonsoft.Json，这样在安装我们的NuGet包Custom.Library.StringUtils时，也会下载和安装Newtonsoft.Json这个NuGet包，保证了所有依赖的DLL文件都被引用到了ASP.NET Core项目"AspNetCore3000Message"中：

之后我们就可以在ASP.NET Core项目中使用.NET Core类库项目中的StringHelper类了，并且可以看到<summary>注释是成功显示的：

参考文献：

How to include XML documentation file in NuGet package built from a project file?

到此这篇关于.NET Core中创建和使用NuGet包的示例代码的文章就介绍到这了,更多相关.NET Core 创建和使用NuGet包内容请搜索来客网以前的文章或继续浏览下面的相关文章希望大家以后多多支持来客网！

相关链接