使用 DotLiquid 做範本渲染時，如果需要使用到非基礎型別當作參數，我們可以為其建立對應的 Drop 型別。 該 Drop 型別繼承自 DotLiquid 的 Drop 型別，在建構子將原型別實體帶入，將原型別具有的成員屬性封裝並開出。 using System.Drawing; namespace DotLiquid.Drops.Model { public class PointDrop : Drop { private readonly Point _point; public PointDrop(Point point) { _point = point; } public int X { get => _point.X; } public int Y { get => _point.Y; } } } 渲染時將參數改成自建的 Drop 型別帶入即可。 ... var model = new {points = points.Select(item => new PointDrop(item)).ToArray()}; return Generate(templateContext, model); .

使用 DotLiquid 做範本渲染時，如果需要使用到自訂型別當作參數，自訂型別可加掛 LiquidTypeAttribute 指定範本會使用到的屬性。 using System; namespace DotLiquid.LiquidType.Model { [LiquidType(nameof(Person.Id), nameof(Person.Name), nameof(Person.NickName))] public class Person { public string Id { get; set; } public string Name { get; set; } public string NickName { get; set; } public Person() { } public Person(string name) { this.Id = Guid.NewGuid().ToString(); this.Name = name; this.NickName = name; } } } 加掛 Attribute 後範本就可以使用自訂型別來渲染。 {% for person in persons -%} hi {{person.NickName}}({{person.Id}}, {{person.Name}})~ {% endfor -%} 渲染時注意要設定使用 CSharpNamingConvention，不然會使用到 Ruby 的命名規則，設定的屬性名稱會被轉為小寫且用底線隔開，會找不到對應的屬性。

要在 DotNet 中使用 Liquid 範本，可先加入 DotLiquid 套件參考。 套件參考加入後，開始撰寫程式部分。 程式撰寫起來很簡單，只要解析範本，然後將範本需要的資料帶進去渲染即可。 ... var template = Template.Parse("hi {{name}}"); var result = template.Render(Hash.FromAnonymousObject(new { name = "Larry" })); ... 運行起來就會看到 DotLiquid 將資料帶進範本渲染出來的結果。 最後提供比較完整的使用範例，筆者將範本放在內嵌資源中，從內嵌資源讀出範本、透過 DotLiquid 將範本與資料帶入渲染。 using System; using System.IO; using System.Reflection; using System.Threading.Tasks; namespace DotLiquid.GettingStarted { class Program { static void Main(string[] args) { var result = GenerateHelloWorld("Larry", "Mylin", "Andrew"); Console.WriteLine(result); } static string Generate(string templateContext, object model) { var template = Template.Parse(templateContext); return template.