StackExchange.Precompilation 项目教程

StackExchange.Precompilation 项目教程

StackExchange.Precompilation Roslyn based csc.exe and aspnet_compiler.exe replacement with metaprogramming hooks for ASP.NET MVC projects from the pre-DNX era 项目地址: https://gitcode.com/gh_mirrors/st/StackExchange.Precompilation

1. 项目介绍

StackExchange.Precompilation 是一个基于 Roslyn 的编译器替换工具，旨在替代传统的 csc.exe 和 aspnet_compiler.exe，为 ASP.NET MVC 5 项目提供元编程钩子。该项目主要用于在预编译阶段对 C# 和 Razor 视图文件进行处理，适用于 ASP.NET MVC 5 项目。

2. 项目快速启动

安装

首先，通过 NuGet 安装 StackExchange.Precompilation.Build 包：

Install-Package StackExchange.Precompilation.Build -Pre

配置

在项目的 .csproj 文件中添加以下配置，以启用 Razor 视图的预编译：

<PropertyGroup>
    <SEPrecompilerIncludeRazor>true</SEPrecompilerIncludeRazor>
</PropertyGroup>

使用预编译视图

在 ViewEngines 中添加 PrecompiledViewEngine：

ViewEngines.Engines.Add(new PrecompiledViewEngine());

使用 C# 7 特性

如果需要在 ASP.NET MVC 5 项目中使用 C# 7 特性，可以添加 RoslynRazorViewEngine：

ViewEngines.Engines.Add(new RoslynRazorViewEngine());

元编程

创建一个新的项目，并实现 ICompileModule 接口：

Install-Package StackExchange.Precompilation -Pre

在目标项目的 web.config 或 app.config 中配置新模块。

3. 应用案例和最佳实践

应用案例

• 性能优化：通过预编译 Razor 视图文件，减少运行时的编译开销，提升应用性能。
• 代码生成：利用元编程钩子在编译阶段生成代码，简化开发流程。

最佳实践

• 版本管理：确保使用最新版本的 StackExchange.Precompilation 包，以获得最新的功能和修复。
• 调试支持：在开发过程中，可以通过添加 System.Diagnostics.Debugger.Launch() 语句来调试编译过程。

4. 典型生态项目

• Roslyn：StackExchange.Precompilation 基于 Roslyn 编译器平台，提供了强大的编译时处理能力。
• ASP.NET MVC 5：该项目主要用于 ASP.NET MVC 5 项目，提供了对 Razor 视图的预编译支持。
• NuGet：通过 NuGet 包管理器，可以方便地安装和管理 StackExchange.Precompilation 及其相关依赖。

通过以上步骤，您可以快速上手并使用 StackExchange.Precompilation 项目，提升 ASP.NET MVC 5 项目的开发效率和性能。

StackExchange.Precompilation Roslyn based csc.exe and aspnet_compiler.exe replacement with metaprogramming hooks for ASP.NET MVC projects from the pre-DNX era 项目地址: https://gitcode.com/gh_mirrors/st/StackExchange.Precompilation