Added Include functionality

Author: robdmoore

README.md

@@ -30,6 +30,30 @@ For intellisense to work it's recommended you add the following to the top of yo
 @inherits RazorLight.TemplatePage<MyModelType>
 ```
 
+or:
+
+```cshtml
+@inherits RazorRenderer.BasePage<MyModelType>
+```
+
+The latter will opt you into functionality added to this library (see below).
+
+## Including a sub-file
+
+The RazorLight `Include` functionality has been disabled since it uses a magic string and this library aims to avoid runtime dynamic functionality, however, there is an include functionality that you can use. If you extend from `RazorRenderer.BasePage<TModel>` from the parent page and the child page:
+
+```cshtml
+@inherits RazorRenderer.BasePage<MyModelType>
+```
+
+Then in your parent file you can include another page using:
+
+```cshtml
+@{ Include<SubPage, MyModelType>(new MyModelType()); }
+```
+
+Where `SubPage` is the typename generated for the included page.
+
 ## Ignoring generated files from source control
 
 It's recommended that you add `*.cshtml.cs` to your `.gitignore` file so that you don't commit the generated files. That avoids superfluous diff/commit noise.

RazorRenderer/BasePage.cs

@@ -0,0 +1,14 @@
+using RazorLight;
+
+namespace RazorRenderer
+{
+    public abstract class BasePage<TModel> : TemplatePage<TModel>
+    {
+        protected void Include<TIncludedPage, TIncludedPageModel>(TIncludedPageModel model)
+            where TIncludedPage : BasePage<TIncludedPageModel>, new()
+        {
+            var newPage = new TIncludedPage();
+            TemplateFileRenderer.RenderIncludedTemplateAsync(this, newPage, model).GetAwaiter().GetResult();
+        }
+    }
+}

RazorRenderer/TemplateFileRenderer.cs

@@ -23,6 +23,16 @@ public async static Task<string> RenderTemplateAsync<T>(ITemplatePage templatePa
             }
         }
 
+        public static async Task RenderIncludedTemplateAsync<T>(ITemplatePage parentPage, BasePage<T> includedTemplatePage, T model)
+        {
+            using (var scope = new MemoryPoolViewBufferScope())
+            {
+                var renderer = new TemplateRenderer(Handler, HtmlEncoder.Default, scope);
+                SetModelContext(includedTemplatePage, parentPage.PageContext.Writer, model, parentPage.PageContext.ViewBag);
+                await renderer.RenderAsync(includedTemplatePage).ConfigureAwait(false);
+            }
+        }
+
         private async static Task RenderTemplateAsync<T>(
             ITemplatePage templatePage,
             T model,
@@ -38,7 +48,7 @@ private async static Task RenderTemplateAsync<T>(
                 await renderer.RenderAsync(templatePage).ConfigureAwait(false);
             }
         }
-
+        
         private static void SetModelContext<T>(
             ITemplatePage templatePage,
             TextWriter textWriter,

Test/ModelType.cshtml

@@ -1,2 +1,6 @@
-@inherits RazorLight.TemplatePage<object>
-<p>@Model.GetType()</p>
+@using Test
+@inherits RazorRenderer.BasePage<object>
+<p>@Model.GetType(): @Model</p>
+@{ Include<SubPage, object>("xyz"); }
+
+<p>After include</p>

Test/Program.cs

@@ -7,12 +7,24 @@ class Program
     {
         static void Main(string[] args)
         {
+            WriteMagenta("date.cshtml");
             Console.WriteLine(new Date().Render((object) null));
+            WriteMagenta("ModelType.cshtml > 1");
             Console.WriteLine(new ModelType().Render(1));
+            WriteMagenta("ModelType.cshtml > 'a'");
             Console.WriteLine(new ModelType().Render("a"));
+            WriteMagenta("Subfolder/date.cshtml");
             Console.WriteLine(new Subfolder.Date().Render((object)null));
+            WriteMagenta("Subfolder/SubSubFolder/date.cshtml");
             Console.WriteLine(new Subfolder.SubSubFolder.Date().Render((object)null));
             Console.ReadLine();
         }
+
+        static void WriteMagenta(string write)
+        {
+            Console.ForegroundColor = ConsoleColor.Magenta;
+            Console.WriteLine(write);
+            Console.ResetColor();
+        }
     }
 }

Test/SubPage.cshtml

@@ -0,0 +1,2 @@
+@inherits RazorRenderer.BasePage<object>
+<p>@Model.GetType(): @Model</p>