aardio 可以非常方便地呼叫 .NET( 不需要任何複雜的步驟 )。
.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
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 庫的原始碼。
import dotNet;
dotNet.import("System")
▶ 嵌入 .NET 視窗控制元件到 aardio 視窗
aardio 視窗嵌入 .NET DataGridView 控制元件範例的執行效果:
如果不想去弄個視窗,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 程式集的 pdb 偵錯檔案:
dotNet.loadFile( "程式集路徑" ,"pdb 偵錯檔案路徑" );
然後用 VS 附加執行的 aardio 程序就可以偵錯了,懂 .NET 的都懂,這個不多說了。
直接看 aardio 程式碼範例:
import dotNet; //建立 C# 語言編譯器 var compiler = dotNet.createCompiler("C#"); //DLL 程式集要提前引入,System.dll 預設已引入,注意這函數不支援記憶體 DLL compiler.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 程式集)。
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 規則)。
用下面的 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 自帶範例,如果大家有任何問題可以下面評論中留言,我會盡快解答。