引言

上一篇中.Net 編譯器平臺 --- Roslyn，介紹了Roslyn的各項功能，包括公開API，使用語法，使用語義，使用工作區等功能。

那麼回到上一篇中提到的問題，實現類似這樣的功能（以下代碼為偽代碼）：

string scriptText = "int a = 1;int b = 2; return a+b ;";

var result = Script.Run(scriptText);

就用到了上一篇提到的 Scripting APIs，還是先瞭解一下Roslyn提供的 Scripting APIs 有哪些。

官方文檔（https://github.com/dotnet/roslyn/blob/main/docs/wiki/Scripting-API-Samples.md） 還是英文版，還是先將他翻譯為中文，以下內容為譯文。

Scripting APIs Samples

腳本 API 可以讓 .NET 應用程式實例化一個 C# 引擎，並針對由宿主提供的對象執行代碼片段。以下是使用腳本 API 併進行一些常見示例的入門示例。您也可以查看腳本 API 的源代碼。

請註意，作為一個語言模型，我無法提供實時的源代碼示例或鏈接到具體的源代碼。但是，您可以參考 Microsoft 的官方文檔和示例來瞭解如何使用腳本 API 並查看相關源代碼。

支持的平臺

腳本 API 需要桌面版 .NET Framework 4.6+ 或 .NET Core 1.1（自 Roslyn v2.0.0-rc3、Visual Studio 2017 RC3 起支持）。

腳本 API 無法在通用 Windows 應用程式和 .NET Native 中使用，因為應用程式模型不支持在運行時載入生成的代碼。

開始準備

安裝 Scripting API NuGet 包：

Install-Package Microsoft.CodeAnalysis.CSharp.Scripting

示例代碼

以下示例代碼中需要添加引用 using Microsoft.CodeAnalysis.CSharp.Scripting;

應用場景：

• 評估一個C#表達式（Evaluate a C# expression）
• 評估一個C#表達式（強類型）（Evaluate a C# expression(strongly-typed)）
• 帶錯誤處理的評估C#表達式（Evaluated a C# expression with error handling）
• 添加引用（Add references）
• 添加命名空間和類型導入（Add namespace and type imports）
• 為腳本參數化（Parameterize a script）
• 創建和構建一個C#腳本，並多次執行（Create&build a C# script and execute it multiple times）
• 創建一個指向腳本的委托（Create a delegate to a script）
• 運行一個C#代碼片段並檢查定義的腳本變數（Run a C# snippet and inspect defined script variables）
• 將代碼片段鏈接成一個腳本（Chain code snippets to form a script）
• 從先前狀態繼續執行腳本（Continue script execution from a previous state）
• 創建和分析一個C#腳本（Create and analyze a C# script）
• 自定義程式集載入（Customize assembly loading）

評估一個C#表達式（Evaluate a C# expression）

object result = await CSharpScript.EvaluateAsync("1 + 2");

評估一個C#表達式（強類型）（Evaluate a C# expression(strongly-typed)）

int result = await CSharpScript.EvaluateAsync<int>("1 + 2");

帶錯誤處理的評估C#表達式（Evaluated a C# expression with error handling）

try
{
    Console.WriteLine(await CSharpScript.EvaluateAsync("2+2"));
}
catch (CompilationErrorException e)
{
    Console.WriteLine(string.Join(Environment.NewLine, e.Diagnostics));
}

添加引用（Add references）

var result = await CSharpScript.EvaluateAsync("System.Net.Dns.GetHostName()", 
ScriptOptions.Default.WithReferences(typeof(System.Net.Dns).Assembly)); 

添加命名空間和類型導入（Add namespace and type imports）

在下麵的代碼中，WithImports("System.IO") 將 using System.IO; 添加到腳本選項中，使得可以在腳本代碼中直接引用 System.IO 命名空間的類型，而無需使用限定符。

var result = await CSharpScript.EvaluateAsync("Directory.GetCurrentDirectory()"), 
                                ScriptOptions.Default.WithImports("System.IO"));

同樣地，WithImports("System.Math") 將 using static System.Math; 添加到腳本選項中，使得可以在腳本代碼中直接引用 System.Math 類型的成員，而無需使用限定符。

var result = await CSharpScript.EvaluateAsync("Sqrt(2)", 
                                ScriptOptions.Default.WithImports("System.Math"));

為腳本參數化（Parameterize a script）

public class Globals
{
    public int X;
    public int Y;
}

var globals = new Globals { X = 1, Y = 2 };

Console.WriteLine(await CSharpScript.EvaluateAsync<int>("X+Y", globals: globals));

:::tip{title="提示"}
目前，Globals 類型必須在從文件載入的程式集中定義。如果程式集在記憶體中（包括在互動式視窗中執行示例時），腳本將無法訪問該類型。請參閱此處的問題。
:::

創建和構建一個C#腳本，並多次執行（Create&build a C# script and execute it multiple times）

var script = CSharpScript.Create<int>("X*Y", globalsType: typeof(Globals));

script.Compile();

for (int i = 0; i < 10; i++)
{
    Console.WriteLine((await script.RunAsync(new Globals { X = i, Y = i })).ReturnValue);
} 

創建一個腳本的委托（Create a delegate to a script）

該委托不會保持編譯資源（語法樹等）處於活動狀態。

var script = CSharpScript.Create<int>("X*Y", globalsType: typeof(Globals));

ScriptRunner<int> runner = script.CreateDelegate();

for (int i = 0; i < 10; i++)
{
    Console.WriteLine(await runner(new Globals { X = i, Y = i }));
} 

運行一個C#代碼片段並檢查定義的腳本變數（Run a C# snippet and inspect defined script variables）

var state = await CSharpScript.RunAsync<int>("int answer = 42;");

foreach (var variable in state.Variables)
     Console.WriteLine($"{variable.Name} = {variable.Value} of type {variable.Type}");

將代碼片段鏈接成一個腳本（Chain code snippets to form a script）

var script = CSharpScript.
            Create<int>("int x = 1;").
            ContinueWith("int y = 2;").
            ContinueWith("x + y");

Console.WriteLine((await script.RunAsync()).ReturnValue); 

從先前狀態繼續執行腳本（Continue script execution from a previous state）

var state = await CSharpScript.RunAsync("int x = 1;");
state = await state.ContinueWithAsync("int y = 2;");
state = await state.ContinueWithAsync("x+y");

Console.WriteLine(state.ReturnValue);

創建和分析一個C#腳本（Create and analyze a C# script）

using Microsoft.CodeAnalysis;

var script = CSharpScript.Create<int>("3");
Compilation compilation = script.GetCompilation();
//do stuff

編譯（Compilation）提供了對完整的 Roslyn API 集合的訪問。

自定義程式集載入（Customize assembly loading）

using Microsoft.CodeAnalysis.Scripting.Hosting;

using (var loader = new InteractiveAssemblyLoader())
{
    var script = CSharpScript.Create<int>("1", assemblyLoader: loader);
    //do stuff 
}

參考

https://github.com/dotnet/roslyn/blob/main/docs/wiki/Scripting-API-Samples.md

作者： Peter.Pan

出處： https://www.cnblogs.com/pandefu/>

郵箱： [email protected]

關於作者：.Net Framework，.Net Core ,WindowsForm,WPF ,控制項庫，多線程

本文版權歸作者和博客園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出 原文鏈接,否則保留追究法律責任的權利。 如有問題， 可郵件咨詢。