多语言笔记系列：使用导入魔法命令

使用导入魔法命令 #!import

笔记本中中，可以管理和使用nuget包，非常方便。

但只使用Nuget包，远远不够。还可以在不将其复制到笔记本的情况下，引用其它笔记、脚本文件(C#、F#、Powershell、Python等语言脚本)、C#编译后的Dll类文件等，并且在后续代码中使用引用执行后的结果。

#!import 魔法命令提供了这一功能。运行时，#!import 命令会从指定路径读取文件，并立即执行其中的代码。对于包含多个单元格的导入笔记本文件，这些单元格将按照它们在文件中出现的顺序运行。

支持的导入类型

由于.NET Interactive支持多种语言，#!import魔法命令可以识别多种语言。如果指定的文件是支持多种语言的格式，例如.ipynb或.dib，那么文件中的不同代码片段将使用其相应的子内核运行，只要导入的内核有对应语言的子内核。

但是#!import不仅仅限于导入其他笔记本文件，它还可以直接加载已知语言的源代码文件，包括：

文件扩展名	详情
.cs	通用C#（注意：这些将使用C#脚本编译器进行编译。）
.csx	C# 脚本
.fs	通用F# 脚本
.fsx	F# 脚本
.html	HTML
.js	JavaScript
.ps1	PowerShell

导入其它笔记文件

真实使用时，比如做教程、写项目演示文档等，都是有很多文档。有些效果要在多外文档中演示；有些脚本、Nuget包、Dll文件等在多个文档中都需要引入;有些需要做成工具类，到处使用等等。

这时，把公共部分提出来，放在单独的文档中编辑好效果，供其它文档引用；这样非常方便。

简单导入示例：运行单元格看效果

• 相对路径：相对当前文档目录

#!import shared/doc/Hello.ipynb

• 相对路径：相对当前文档目录

#!import ./shared/doc/Hello.ipynb

• 绝对路径：因为路径太固定，换个位置或换台电脑，就不能执行。 可使用下面的动态导入

//执行很可能报错，看下面 "动态导入"
#!import "C:\Users\ruyu\Desktop\多语言笔记学习\Docs\shared\doc\Hello.ipynb"

动态导入(高级导入)

使用绝对路径时，可移置性就太差啦！或者 需要导入10个或不确定的多个文件，那就很繁琐甚至无法完成。我总结了一个高级的动态用法。

• 示例1：利用C#程序，多次执行导入

using Microsoft.DotNet.Interactive;
using Microsoft.DotNet.Interactive.Commands;
{ //动态执行:多次执行

    for(int i=0; i<3; i++)
    {
        await Kernel.Root.SendAsync(new SubmitCode( $"#!import ./shared/doc/Hello.ipynb",  "csharp"));
    }
}

• 示例2：利用C#程序，灵活设置各种目录

using Microsoft.DotNet.Interactive;
using Microsoft.DotNet.Interactive.Commands;
{ //动态执行:绝对路径(当前目录转换为绝对目录，增加可移置性与灵活性)

    string currentDic = Environment.CurrentDirectory;
    string fullPath = System.IO.Path.Combine(currentDic,"shared/doc/Hello.ipynb");

    await Kernel.Root.SendAsync(new SubmitCode( $"#!import {fullPath}",  "csharp"));
}

综合应用

创建一个 初始化文档 ini.ipynb, 统一放置：公用nuget包引用、公用命名空间引用、公共对象、公用方法与共享变量等，供其它文档统一引用进行初始化。

#!import "./shared/doc/Ini.ipynb"

• 使用导入文档中引用 nuget 包及引用的命名空间

//使用 Newtonsoft.Json
var person = new {Name = "张三", Age = 52};

//没有引用命名空间要写全
var jsonText1 = Newtonsoft.Json.JsonConvert.SerializeObject(person);
Console.WriteLine(jsonText1);

//初始化文档中引入了之后
var jsonText2 = JsonConvert.SerializeObject(person);

Console.WriteLine(jsonText2);

• 使用导入文档中的公用类

Student student = new Student(){Id=2, Name = "王安全", Age = 12};
student.Display();

• 用导入文档中的公用变量

SharedStudent.Display();

• 使用导入文档中的公用方法(静态方法做工具类)

var s = StudentToString(SharedStudent);
s.Display();

导入 C# 脚本

#!import "./shared/script/tools.cs"

//作用C#脚本功能
var callTools = Tools.GetCurrentPath();
callTools.Display();

导入 PowerShell 脚本

#!import "./shared/script/tools.ps1"

导入 JS 脚本

#!import "./shared/script/tools.js"

导入 html

#!import "./shared/script/tools.html"

.NET Projects

目前不支持在.NET项目上下文中导入或引用完整的.NET项目或源文件。如果你在.NET项目中有想要在笔记本中使用的功能，你可以先编译它，然后使用#r '/path/to/assembly.dll'直接引用程序集，或者将其打包并使用#r nuget引用NuGet包。

不过，正在考虑改进与.NET项目的集成。