.NET把文件嵌入到程序集中的EmbeddedFile
简介
有时候我们在发布程序时，不想让客户看到项目中的文件，这时就可以使用.NET的嵌入文件功能（虚拟文件）。在.NET中，虚拟文件（Virtual File）是一种特殊类型的文件，它们在编译时被嵌入到程序集中，而不是作为独立的文件存在于文件系统中。EmbeddedFile是指在编译时将文件内容嵌入到程序集中，并通过虚拟路径来访问的文件。
使用步骤：
1、嵌入的文件配置
首先将要嵌入的文件添加到项目中，我们在vs项目中新建一个名为"dotnet"的文本文件，并右键属性设置其生成操作为 "嵌入的资源"。设置完成右键选择项目 "属性"，然后在属性窗口中 "生成" 选项来完成嵌入。如下图：
生成后的文件夹是没有这个文件，如下图
2、文件说明
在代码中可以使用虚拟路径来访问嵌入的文件。虚拟路径是指通过程序集的命名空间和文件名来构建的路径。例如，如果嵌入的文件名为 "dotnet.txt"，它位于命名空间为 "Test7" 的程序集中，那么虚拟路径就是 "Test7.dotnet.txt"。
3、用C#代码读取嵌入文件
参考代码如下：
using System;
using System.IO;
using System.Reflection;
using System.Text;
namespace Test7
{
class Program
{
static void Main(string[] args)
{
string embeddedFilePath = "Test7.dotnet.txt";
string fileContent = ReadEmbeddedFile(embeddedFilePath);
Console.WriteLine(fileContent);
}
static string ReadEmbeddedFile(string embeddedFilePath)
{
Assembly assembly = Assembly.GetExecutingAssembly();
//如果跨程序访问或者不确定文件，这里可以判断文件流是否为null
using (Stream stream = assembly.GetManifestResourceStream(embeddedFilePath))
{
if (stream == null)
{
throw new Exception("Embedded文件未发现: " + embeddedFilePath);
}
using (StreamReader reader = new StreamReader(stream))
{
return reader.ReadToEnd();
}
}
}
}
}
在上面的示例中，`ReadEmbeddedFile` 方法通过虚拟路径获取嵌入的文件流，并使用 `StreamReader` 读取文件内容。然后，将文件内容打印到控制台。
注意：虚拟文件的路径是区分大小写的，并且要正确地指定命名空间和文件名。此外，如果文件位于不同的程序集中，你需要使用正确的程序集名称来构建虚拟路径。
结语
本文讲述了在 .NET Core 中使用虚拟文件（EmbeddedFile）的基本方法。当然你也可以将任意类型的文件（例如文本文件、图像文件等）嵌入到程序集中，并以使用上面的方式指定虚拟路径的方式访问它们。它的好处是嵌入方便发布程序，尤其是winform桌面类别的程序。希望本文对你有所收获，欢迎留言或者吐槽！
参考：
1、learn.microsoft.com/zh-cn/dotnet/core/extensions/resources
2、chatgpt
来源公众号：DotNet开发跳槽
