结合 ASP.NET v5 使用 TypeScript

与 ASP.NET v5 一起使用 TypeScript 需要你用特定的方式来设置你的工程。 更多关于 ASP.NET v5 的详细信息请查看 ASP.NET v5 文档 (opens new window) 在 Visual Studio 的工程里支持当前的 tsconfig.json 还在开发之中，可以在这里查看进度 #3983 (opens new window)。

工程设置

我们就以在 Visual Studio 2015 里创建一个空的 ASP.NET v5 工程开始，如果你对 ASP.NET v5 还不熟悉，可以查看这个教程 (opens new window)。

然后在工程根目录下添加一个 scripts 目录。 这就是我们将要添加 TypeScript 文件和tsconfig.json 文件来设置编译选项的地方。 请注意目录名和路径都必须这样才能正常工作。 添加 tsconfig.json 文件，右键点击 scripts 目录，选择 Add ， New Item 。 在 Client-side 下，你能够找到它，如下所示。

最后我们还要将下面的选项添加到 tsconfig.json 文件的 "compilerOptions" 节点里，让编译器输出重定向到 wwwroot 文件夹：

"outDir": "../wwwroot/"

下面是配置好 tsconfig.json 后可能的样子

{
    "compilerOptions": {
        "noImplicitAny": false,
        "noEmitOnError": true,
        "removeComments": false,
        "sourceMap": true,
        "target": "es5",
        "outDir": "../wwwroot"
    }
}

现在如果我们构建这个工程，你就会注意到 app.js 和 app.js.map 文件被创建在 wwwroot 目录里。

工程与虚拟工程

当添加了一个 tsconfig.json 文件，你要明白很重要的一点是我们创建了一个虚拟 TypeScript 工程，在包含 tsconfig.json 文件的目录下。 被当作这个虚拟工程一部分的 TypeScript 文件是不会在保存的时候编译的。 在包含 tsconfig.json 文件的目录外层里存在的 TypeScript 文件不会被当作虚拟工程的一部分。 下图中，可以见到这个虚拟工程，在红色矩形里。

保存时编译

想要启用 ASP.NET v5 项目的保存时编译功能，你必须为不是虚拟 TypeScript 工程一部分的 TypeScript 文件启用保存时编译功能。 如果工程里存在 tsconfig.json 文件，那么模块类型选项的设置会被忽略。