.NET 在 aardio 中很好用,系统自带 .NET 组件以及各种开源 .NET 组件在 aardio 用户中也很受欢迎。
aardio + .NET 天生的 EXE —— 可避免被 ILSpy 直接反编译。
aardio 调用 .NET 示例:

//导入 .NET 支持库import dotNet; //导入.NET 程序集dotNet.import("System"); //调用类的静态成员函数var isValidHost = System.Uri.CheckHostName("www.aardio.com"); //布局 .NET 工具var uri = System.Uri("https://www.aardio.com/test?q=aardio");//读或写 .Net 工具的实例属性var host = uri.Host;//调用 .Net 工具实例的成员函数var hash = uri.GetHashCode();
aardio 语法与 JavaScript 靠近,请参考:aardio 编程措辞快速入门——语法速览
aardio + .Net 开拓对 .NET 版本没有严格哀求 —— 兼容盛行 Windows 系统自带的不同版本 .NET。不但可以调用系统自带的大量 .NET 组件,也可以天生体积很小的 EXE 文件。
Win7 自带 .Net 3.5.1,支持 lambda
Win8 自带 .Net 3.5.1 + .Net 4.5
Win10 自带 .Net 4.6
Win10 1709 自带 .Net 4.7.1 ,支持 ValueTuple
Win11 自带 .NET 4.8
内存加载 .NET 程序集,天生独立 EXE
aardio 供应 dotNet.reference() 函数 —— 可以方便地通过内存数据加载 .NET 程序集,这样就可以天生独立 EXE 程序,不再须要带上一堆 DLL 文件。
将内存数据绑定为 .NET 程序集示例:
import dotNet;dotNet.reference({ ["test.mydll"] = $"\test.mydll.dll"; ["test.core"] = $"\test.core.dll"; });
dotNet.reference() 的第 1 个参数指定程序集名称,第 2 个参数指定实际要加载的程序集路径或内存数据,aardio 代码在文件路径前加 $ 号可将文件数据编译为二进制字符串( 发布后不再须要原文件 )。
然后就可以正常导入内存程序集了,代码如下:
dotNet.import("test.mydll");
上面的代码导入 .NET 程序集,然后再将 .NET 名字空间导入 aardio ,dotNet.import() 函数的浸染与下面的代码相同:
//导入 .NET 程序集var assembly = dotNet.load("test.mydll"); //导入 .NET 名字空间assembly.import("test.mydll");
aardio 标准库供应的 .NET 库aardio 标准库中已经供应了一些 .NET 库,例如 System ,调用示例:
//导入 .NET 名空间import System; //用 System 名字空间下面的类布局工具实例var uri = System.Uri("https://www.aardio.com/test?q=aardio")//读或写 .Net 工具的实例属性var host = uri.Host ;
aardio 代码一样平常利用小驼峰命名风格,但 .NET 名字空间或类名一样平常会大写首字母以示差异。
我们右键点 System ,在弹出菜单内点击「跳转到定义」看一下 System 库的源代码。
可以看到这个 Sytem 库的关键代码只有两句:
import dotNet;dotNet.import("System")
嵌入 .NET 窗口控件到 aardio 窗口aardio 窗口嵌入 .NET DataGridView 控件范例的运行效果:
首先要理解 .Net 的所有控件都应该放在 .Net 创建的窗口里(也便是 System.Windows.Forms.Form 工具),窗口是管理控件的容器,不能直接把控件单独拧出来往 aardio 窗口里扔。
如果不想去弄个窗口,aardio 供应了一个更大略的方法 ,例如把 .Net 的 DataGridView 控件直接嵌入 aardio 窗口:
import System.Windows.Forms;var Forms = System.Windows.Forms; var dataGridView = Forms.CreateEmbed("DataGridView",winform.custom);
非常大略。
好了,现在创建 DataTable 数据表,准备把他显示到控件里,先创建数据列,重点看怎么指定列字段利用的数据类型:
//添加数据列var dataTable = System.Data.DataTable("DT"); dataTable.Columns.Add("名称");//添加列dataTable.Columns.Add("计数",System.Type.GetType("System.Double")); //添加指天命据类型的列dataTable.Columns.Add("选择",System.Type.GetType("System.Boolean")); //自动显示复选框
然后绑天命据源到视图:
//绑天命据源到视图var dataView = System.Data.DataView(dataTable);dataGridView.DataSource = dataView;dataGridView.EditMode=2;
好吧,想再加一个下拉框吗?!
这个就略有些麻烦了,代码如下:
//先移除自动天生的列dataGridView.Columns.Remove("名称"); //下面添加下拉框以更换上面移除的列var cmbColumn = Forms.DataGridViewComboBoxColumn();cmbColumn.Width = 120; cmbColumn.Name = "Name";cmbColumn.DataPropertyName = "名称";//对应上面 dataTable 里的字段名cmbColumn.HeaderText = "名称"; //显示在列标题里的文本 //如果名称与显示值一样,那直接给 cmbColumn.DataSource 赋值一个数组就可以//下面绑定下拉候选框的数据源,上面的 DataPropertyName 才是真正要读写的数据值。cmbColumn.DisplayMember = "Name";//下拉框显示文本的属性名cmbColumn.ValueMember = "Value"; //下拉框选项值的属性名cmbColumn.DataSource = dotNet.createNameValueList( { "王五","张三"}, { "WangWu","ZhangSan"});//添加这个新的下拉框到数据视图dataGridView.Columns.Add(cmbColumn);//移动到第一列dataGridView.Columns.Item["Name"].DisplayIndex = 0;
然后添加下面的代码相应 .NET 控件的事宜:
//添加事宜(event)dataTable.ColumnChanged = function(sender,eventArgs){ var columnName = eventArgs.Column.ColumnName; var value = eventArgs.Row.getItem(columnName); winform.edit.print("已改变列:",columnName," 已变更值:",value);}
然后读写数据:
//添加测试数据var row = dataTable.NewRow(); row.ItemArray = {"WangWu",123, true}dataTable.Rows.Add(row); //读取数据winform.button.oncommand = function(id,event){ for(i=1;dataTable.Rows.Count;1){ var arr = dataTable.Rows[i].ItemArray; winform.edit.print( arr[1] ) ; } }
以上完全范例源代码请参考 aardio 自带范例:
aardio 范例 / 调用其他措辞 / .Net / 控件窗口 / 嵌入控件
可以看到 aardio 自带了大量调用 .NET 的范例。
在 aardio 中加载的 .NET 程序集如何调试用下面的代码在 aardio 中加载 .NET 程序集的 pdb 调试文件:
dotNet.loadFile( "程序集路径" ,"pdb 调试文件路径" );
然后用 VS 附加运行的 aardio 进程就可以调试了,懂 .NET 的都懂,这个不多说了。
用 aardio 在运行时编译 C# 源码直接看 aardio 代码示例:
import dotNet; //创建 C# 措辞编译器var compiler = dotNet.createCompiler("C#");//DLL 程序集要提前引入,System.dll 默认已引入,把稳这函数不支持内存 DLLcompiler.Reference("System.dll");//设置待编译C#源码( 注释可赋值为字符串,注释标记首尾星号数目要同等 )compiler.Source = / ?> /如果 C# 代码开始于 aardio 模板标记,则启用 aardio 模板语法。参考:《aardio 利用手册 / aardio 措辞 / 模板语法》/namespace CSharpLibrary { public class Object { <? if _WINXP { ?> public string Test(){ return "Windows XP"; } <? } else { ?> public string Test(){ return "<?= win.version.name ?>"; } <? } ?> } } /import win.version;//编译并返回程序集,可选在参数中指定输出 DLL文件,不指定则编译为内存程序集。var assembly = compiler.CompileOrFail(/"/output.dll"/); //导入名字空间,也可以直接写 compiler.import("CSharpLibrary"); assembly.import("CSharpLibrary"); //利用 C# 编写的类布局工具实例 var netObj = CSharpLibrary.Object();//调用实时编译的C#函数var ret = netObj.Test(); import console;console.log( ret );console.pause();
把稳 aardio 中的注释可赋值为字符串,由于 aardio 哀求段注释的首尾星号数目必须同等,以是不会与其他编程措辞冲突,很适宜用来放其他编程措辞的源代码。
上面的 compiler.Source 可以用一个字符串指定 C# 源码,这个字符串支持类似 PHP 的模板语法,以是我们可以用 aardio 代码灵巧地在运行时生态天生比较繁芜的 C# 源代码,然后再用 .NET 编译为程序集。aardio 中的 dotNet.desktop 扩展库就利用了这种技能用很少的代码就实现了虚拟桌面管理支持库。
默认可以将 C# 源码编译为内存程序集,这样很适宜天生独立 EXE 文件。
把稳在 aardio 中编译 C#,调用的是 CLR,而 CLR 只有 2.0 / 4.0 的差异,运行时编译也只支持这两个版本的语法。例如安装了 .Net 3.5 但没有安装 .Net 4.x ,那么 CLR 2.0 下编译器不支持 var ,lambda 这些语法 (但是能运行编译后的 DLL,可以事先用 VS 编译 C# 代码天生 DLL 程序集)。
.NET 与 aardio 工具相互转换规则aardio 会自动处理类型转换,调用 .NET 函数时如果参数类型不一致 —— aardio 也会尽最大可能地转换参数类型,用起来还是比较轻松的。但大略理解一下类型转换规则和事理是有必要的。
所有原生 .NET 工具在 aardio 等分为两类:
1、可自动转换的大略值类型
null值、数值、字符串、列举、 System.Drawing.Color 等大略值类型,以及这些值类型的数组可以直接交流。aardio 中的 buffer 在 .NET 中对应字节数组。
2、在 aardio 中存为 COM 工具的 .NET 工具
其他原生 .NET 工具在 aardio 存为 com.NETObject 工具(对应 .NET 中的 System.__ComObject 类型),个中有些分外的 .NET 工具(例如 struct,ValueTuple),在传入 aardio 时会封包为分外的 DispatchableObject 工具。这些 .NET 工具在 aardio 中都会被封装为 dotNet.object 工具,在 aardio 中利用没有太大差异。
aardio 与 .NET 交互基于 COM 接口,以是遵守 aardio 的 COM 传参基本规则:
aardio 中的整数传入 .NET 默认为 int32,小数默认为 double 类型。aardio 数值数组传入 .NET 默认为 double 类型 COM 数组,纯字符串数组一律转为 BSTR 数组。其他数组转为 Variant 变体类型数组。
.NET 中的 enum 列举会自动转换为 aardio 中的数值(双向自动转换),
.NET 中的 struct,tuple 由 .NET 工具 DispatchableObject 封包后再返回 aardio 。
aardio 函数则自动转换为委托、事宜所须要的委托类型。
.NET 中的 System.IntPtr,System.UIntPtr 类型在 aardio 中会自动转换为整数值,
aardio 中的指针类型(pointer)必须利用 tonumber() 函数转换为数值才能传入 .NET。
窗口句柄( HWND ) 在 aardio 以整数值表示,可以直接传入 .NET。
System.Drawing.Color 在 aardio 则会自动转换为 ARGB 格式的颜色数值。
调用 .NET 时 ARGB 格式的颜色数值也能自动转换为 System.Drawing.Color 工具。
把稳 GDI+ 利用 ARGB 格式颜色值,与 gdip库,plus 控件等兼容。
aardio 供应以下函数创建指定静态类型的 dotNet.object 工具:
dotNet.object(value,byRef) 转换为 .Net 工具。
dotNet.byte(value,byRef) 转换为 8 位整型数值。
dotNet.ubyte(value,byRef) 转换为 8 位无符号整型数值。
dotNet.word(value,byRef) 转换为 16 位整型数值。
dotNet.uword(value,byRef) 转换为 16 位无符号整型数值。
dotNet.int(value,byRef) 转换为 32 位整型数值。
dotNet.uint(value,byRef) 转换为 32 位无符号整型数值。
dotNet.long(value,byRef) 转换为 64 位整型数值。
dotNet.ulong(value,byRef) 转换为 64 位无符号整型数值。
dotNet.float(value,byRef) 转换为 32 位浮点数值。
dotNet.double(value,byRef) 转换为 64 位浮点数值
以上函数会将参数 1 存为 .NET 工具并封包为 DispatchableObject 工具后再返回 dotNet.object 工具,( 大略的值类型也会转换为 dotNet.object 工具 ),这可以让 aardio 直接引用 .NET 中的工具,方便实现 ref,out 等输出参数。
下面的 aardio 代码演示了 dotNet.object 的用法:
import dotNet; var compiler = dotNet.createCompiler("C#");//指定 C# 源代码compiler.Source = /namespace CSharpLibrary { public class Object { public static void Test(ref double num,int [] arr){ num = 12.3; arr[0] = 56; } } } ///编译程序集并导入名字空间 compiler.import("CSharpLibrary"); //创建 .Net 工具,启用引用传参。 var num = dotNet.double(12.5,true);//创建 .Net 数组 var arr = dotNet.int({1,2,3}); //调用 .NET 函数。CSharpLibrary.Object.Test(num,arr); import console;/dotNet.object 工具如果存储的是数组,可用下标直接读写数组成员。/console.log( arr[1] ) /dotNet.object 工具如果存储的是 Primitive,enum,string 类型或这些类型的普通数组,则可利用 Value 属性读写原始值。/console.log( num.Value ); //支持 tostring() 转换为字符串,tonumber() 转换为数值。console.log(tostring(num),tonumber(num)); console.pause();
下标C# 中的 下标操作符[] 实际上会被自动转换为访问 Item[] 下标属性。
先看 aardio 代码示例:
import dotNet; var compiler = dotNet.createCompiler("C#");compiler.Source = / using System;using System.Collections.Generic;namespace CSharpLibrary { public class TestClass { private Object [] values = new Object [] {1,2,3,4,5,6,7,8,9}; public Object this [int index] { get { return values[index]; } set { values[index] = value; } } public Dictionary<string,string> dict = new Dictionary<string,string> (); }} / //编译并引入 C# 名字空间compiler.import("CSharpLibrary"); //利用 C# 编写的类布局工具实例var netObj = CSharpLibrary.TestClass(); //读下标属性,按 C# 规则起始下标为0,而非 aardio 中的起始下标为 1。var item = netObj.Item[5];var item = netObj.getItem(5); //这样读下标属性也可以,支持多参数var item = netObj.Item(5); //get 前缀可以省略//写下标属性netObj.Item[5] = 123;netObj.setItem(5); //这样写下标属性也可以,支持多参数//如果.NET 工具的下标为数值,许可省略 Item,但这时候起始下标为 1。var item = netObj[6]; //也可以下面这样赋值:netObj[6] = 123; import console;console.log(netObj[6]); //字典也可以这样访问netObj.dict.Item["test"] = "abc";console.log( netObj.dict.Item["test"] );console.pause();
要点:
1、在 aardio 中须要用 Item[] 访问 .NET 工具的 Item 属性。这时候要把稳起始下标为 0 ( 遵守 C# 规则 )。
2、如果下标为数值可以省略 Item 直接写 [],但这时要起始下标为 1 (遵守 aardio 规则)。
调用 UWP用下面的 aardio 代码创建支持调用 UWP 组件的 C# 编译器:
import dotNet.uwpCompiler var uwpCompiler = dotNet.uwpCompiler( "\ocr.dll" )
可选在 dotNet.uwpCompiler 的第 2 个参数指定 Windows.winmd 的路径,如果没有指定 aardio 会自动到下面的目录去查找最新版本 Windows 10 SDK 目录( 须要事先安装 ):
C:\Program Files (x86)\Windows Kits\10\UnionMetadata
然后在 SDK 目录下查找 Windows.winmd。我们只是在编译程序集时须要 Windows.winmd,运行时不须要它( 也不须要 Windows 10 SDK )。
例如 aardio 标准库 dotNet.ocr 包含的 ocr.dll 便是用下面的代码编译的:
import dotNet.uwpCompiler var uwpCompiler = dotNet.uwpCompiler( "\ocr.dll" )//启用编译优化uwpCompiler.Parameters.CompilerOptions = "/optimize" //设置待编译C#源码uwpCompiler.Source = / using System;using System.Reflection; using System.Collections; using System.Collections.Generic;using System.IO;using System.Threading.Tasks; using Windows.Graphics.Imaging;using Windows.Storage;using Windows.Storage.Streams;using System.Runtime.InteropServices;using Windows.Media.Ocr;namespace aardio { public class UwpOcrResult{ public UwpOcrResult(OcrResult ocrRet) { ocrResult = ocrRet; } public int LineCount() { return ocrResult.Lines.Count; } public string [] GetWords(int index) { ArrayList arr = new ArrayList(); foreach (var word in ocrResult.Lines[index].Words) { arr.Add(word.Text); } return (string[])arr.ToArray(typeof(string)); } public object GetWordRects(int index) { ArrayList arr = new ArrayList(); foreach (var word in ocrResult.Lines[index].Words) { double[] rc = { word.BoundingRect.Left, word.BoundingRect.Top, word.BoundingRect.Right, word.BoundingRect.Bottom }; arr.Add(rc); } return (object)arr.ToArray(typeof(object)); } private OcrResult ocrResult;}public class UwpOcrEngine { public string [] AvailableRecognizerLanguages(){ ArrayList arr = new ArrayList(); foreach (var lang in OcrEngine.AvailableRecognizerLanguages) { arr.Add(lang.LanguageTag); } return (string [])arr.ToArray(typeof( string)); } public object IsLanguageSupported( string name ){ Windows.Globalization.Language lang = new Windows.Globalization.Language(name); return OcrEngine.IsLanguageSupported(lang); } public UwpOcrResult Recognize(byte[] imgBuffer, string language){ return new UwpOcrResult( RecognizeAsync(imgBuffer, language).GetAwaiter().GetResult() ); } async Task<OcrResult> RecognizeAsync(byte[] imgBuffer, string language) { var randomAccessStream = new InMemoryRandomAccessStream(); var outputStream = randomAccessStream.GetOutputStreamAt(0); var dw = new DataWriter(outputStream); var task = new Task(() => dw.WriteBytes(imgBuffer)); task.Start(); await task; await dw.StoreAsync(); await outputStream.FlushAsync(); BitmapDecoder decoder = await BitmapDecoder.CreateAsync(randomAccessStream); SoftwareBitmap softwareBitmap = await decoder.GetSoftwareBitmapAsync(BitmapPixelFormat.Bgra8, BitmapAlphaMode.Premultiplied); Windows.Globalization.Language lang = new Windows.Globalization.Language(language); OcrEngine engine = OcrEngine.TryCreateFromLanguage(lang); if (engine != null) { OcrResult ocrResult = await engine.RecognizeAsync(softwareBitmap); return ocrResult; } return null; }} } ///编译并返回程序集 var assembly = uwpCompiler.CompileOrFail();import console;if(assembly) console.logPause("编译成功",uwpCompiler.Parameters.OutputAssembly);
dotNet.ocr 支持库的体积很小,可以天生独立 EXE 文件,调用代码也非常简洁。下面是调用 示例:
更多
aardio 供应的 .NET 范例非常多,更多功能请参考 aardio 自带范例,如果大家有任何问题可以下面评论中留言,我会尽快解答。