include ../_util-fns

<a id="top"></a>
:marked
   Some developers prefer Visual Studio as their Integrated Development Environment (IDE).

   有些开发者喜欢用Visual Studio。

   This cookbook describes the steps required to set up and use the
   Angular QuickStart files in **Visual Studio 2015 within an ASP.NET 4.x project**.

   本烹饪宝典介绍了在**Visual Studio 2015的ASP.NET 4.x项目中**，用Angular实现“快速起步”所需的步骤。
     
.l-sub-section
  :marked
    There is no *live example* for this cookbook because it describes Visual Studio, not the application.

    本烹饪宝典中没有*在线例子*，因为它介绍的是Visual Studio，而不是应用程序。

.l-main-section
<a id="asp-net-4"></a>
:marked
  ## ASP.NET 4.x Project

  ## ASP.NET 4.x 项目
  
  This cookbook explains how to set up the QuickStart files with an **ASP.NET 4.x project** in
  Visual Studio 2015.
  
  本烹饪书解释了如何使用Visual Studio 2015在**ASP.NET 4.x项目**中设置**快速开始**文件。
.l-sub-section
  :marked
    If you prefer a `File | New Project` experience and are using **ASP.NET Core**, 
    then consider the _experimental_
    <a href="http://blog.stevensanderson.com/2016/10/04/angular2-template-for-visual-studio/" target="_blank">ASP.NET Core + Angular 2 template for Visual Studio 2015</a>. 
    Note that the resulting code does not map to the docs. Adjust accordingly.   
    
    如果你希望使用**ASP.NET Core**并体验全新项目，
    参见_预览版_<a href="http://blog.stevensanderson.com/2016/10/04/angular2-template-for-visual-studio/" target="_blank">ASP.NET Core + Angular 2 template for Visual Studio 2015</a>。 
    注意，最终代码与本文不对应，请适当调节。
  
:marked
  The steps are as follows:
  
  步骤如下:
  
  - [Prerequisite](#prereq1): Install Node.js

  - [前提条件](#prereq1): 安装Node.js
  
  - [Prerequisite](#prereq2): Install Visual Studio 2015 Update 3
  
  - [前提条件](#prereq2): 安装Visual Studio 2015 Update 3
  
  - [Prerequisite](#prereq3): Configure External Web tools
  
  - [前提条件](#prereq3): 配置External Web tools
  
  - [Prerequisite](#prereq4): Install TypeScript 2 for Visual Studio 2015
  
  - [前提条件](#prereq4): 安装TypeScript 2 for Visual Studio 2015

  - [Step 1](#download): Download the QuickStart files

  - [第一步](#download): 下载“快速起步”的文件

  - [Step 2](#create-project): Create the Visual Studio ASP.NET project

  - [第二步](#create-project): 创建Visual Studio ASP.NET项目

  - [Step 3](#copy): Copy the QuickStart files into the ASP.NET project folder

  - [第三步](#copy): 把“快速起步”中的文件拷贝到ASP.NET的项目目录中

  - [Step 4](#restore): Restore required packages
  
  - [第四步](#restore): 恢复需要的包

  - [Step 5](#build-and-run): Build and run the app

  - [第五步](#build-and-run): 构建和运行应用程序
  
.l-main-section
h2#prereq1 Prerequisite: Node.js

h2#prereq1 前提条件: Node.js

:marked
  Install **[Node.js® and npm](https://nodejs.org/en/download/)**
  if they are not already on your machine.

  如果你的电脑里没有Node.js®和npm，请安装**[它们](https://nodejs.org/en/download/)**。

.l-sub-section
  :marked
    **Verify that you are running node version `4.6.x` or greater, and npm `3.x.x` or greater**
    by running `node -v` and `npm -v` in a terminal/console window.
    Older versions produce errors.
    
    在终端或者控制台中运行`node -v`和`npm -v`，**请确认你的Node版本为`4.6.x`或更高，npm的版本为`3.x.x`或更高**。老版本会引起错误。
.l-main-section
h2#prereq2 Prerequisite: Visual Studio 2015 Update 3

h2#prereq2 前提条件: Visual Studio 2015 Update 3
:marked
  The minimum requirement for developing Angular 2 applications with Visual Studio is Update 3.
  Earlier versions do not follow the best practices for developing applications with TypeScript.
  To view your version of Visual Studio 2015, go to `Help | About Visual Studio`.

  使用Visual Studio开发Angular 2应用程序的最低要求是Update 3。
  早期版本没有遵循使用TypeScript开发应用程序的最佳实践。
  要查看你的Visual Studio 2015版本号，到`Help | About Visual Studio`。
  
  If you don't have it, install **[Visual Studio 2015 Update 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs)**.
  Or use `Tools | Extensions and Updates` to update to Update 3 directly from Visual Studio 2015.

  如果还没有，安装**[Visual Studio 2015 Update 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs)**。或者使用`Tools | Extensions and Updates`来直接在Visual Studio 2015中更新到Update 3。

.l-main-section
h2#prereq3 Prerequisite: Configure External Web tools

h2#prereq3 前提条件: 配置External Web tools
:marked
  Configure Visual Studio to use the global external web tools instead of the tools that ship with Visual Studio:

  配置Visual Studio来使用全局External Web Tools，而非Visual Studio默认的工具：

    * Open the **Options** dialog with `Tools` | `Options`

    * 到`Tools` | `Options`打开**Options**对话框

    * In the tree on the left, select `Projects and Solutions` | `External Web Tools`.

    * 在左边树型项目中，选择`Projects and Solutions` | `External Web Tools`。

    * On the right, move the `$(PATH)` entry above the `$(DevEnvDir`) entries. This tells Visual Studio to
      use the external tools (such as npm) found in the global path before using its own version of the external tools.

    * 在右侧，将`$(PATH)`移动到 `$(DevEnvDir`)上面。这样，Visual Stuio就会在使用自带的外部工具时，优先使用全局路径中的外部工具（比如npm）。

    * Click OK to close the dialog.

    * 点击OK关闭对话框。

    * Restart Visual Studio for this change to take effect.

    * 重启Visual Studio，以让设置变化生效。

  Visual Studio will now look first for external tools in the current workspace and 
  if not found then look in the global path and if it is not found there, Visual Studio
  will use its own versions of the tools.

  Visual Studio将优先在当前的工作区查找外部工具，如果没有找到，便查找全局路径，如果还没有找到，Visual Studio就使用自带的工具版本。

.l-main-section
h2#prereq4 Prerequisite: Install TypeScript 2 for Visual Studio 2015

h2#prereq4 前提条件: 安装TypeScript 2 for Visual Studio 2015
:marked
  While Visual Studio Update 3 ships with TypeScript support out of the box, it currently doesn’t ship with TypeScript 2, 
  which you need to develop Angular 2 applications.

  Visual Studio Update 3自带TypeScript支持，但是它的TypeScript版本开发Angular 2应用需要的不是2。

  To install TypeScript 2:

  要安装TypeScript 2：

   * Download and install **[TypeScript 2.0 for Visual Studio 2015](http://download.microsoft.com/download/6/D/8/6D8381B0-03C1-4BD2-AE65-30FF0A4C62DA/TS2.0.3-TS-release20-nightly-20160921.1/TypeScript_Dev14Full.exe)**

   * 下载并安装**[TypeScript 2.0 for Visual Studio 2015](http://download.microsoft.com/download/6/D/8/6D8381B0-03C1-4BD2-AE65-30FF0A4C62DA/TS2.0.3-TS-release20-nightly-20160921.1/TypeScript_Dev14Full.exe)**

   * OR install it with npm: `npm install -g typescript@2.0`.

   * 或者，通过NPM来安装：`npm install -g typescript@2.0`。

  You can find out more about TypeScript 2 support in Visual studio **[here](https://blogs.msdn.microsoft.com/typescript/2016/09/22/announcing-typescript-2-0/)**

  你可以在**[这儿](https://blogs.msdn.microsoft.com/typescript/2016/09/22/announcing-typescript-2-0/)**查看更多Visual Studio中TypeScript 2的支持。

  At this point, Visual Studio is ready. It’s a good idea to close Visual Studio and 
  restart it to make sure everything is clean.

  至此，Visual Studio准备好了。重新启动Visual Stuido，这样我们可以有一个崭新的开始。

.l-main-section
h2#download Step 1: Download the QuickStart files

h2#download 第一步: 现在“快速起步”文件

:marked
  [Download the QuickStart source](https://github.com/angular/quickstart)
  from github. If you downloaded as a zip file, extract the files.

  从github[下载“快速起步”的源代码](https://github.com/angular/quickstart)。如果下载的是一个压缩的zip文件，解压它。

.l-main-section
h2#create-project Step 2: Create the Visual Studio ASP.NET project

h2#create-project 第二步：创建Visual Studio ASP.net项目

:marked
  Create the ASP.NET 4.x project in the usual way as follows:
  
  按照下列步骤创建ASP.NET 4.x项目：
  
  * In Visual Studio, select `File` | `New` | `Project` from the menu.
  
  * 在Visual Studio中，选择`File` | `New` | `Project`菜单。

  * In the template tree, select `Templates` | `Visual C#` (or `Visual Basic`) | `Web`.

  * 在模板树中，选择`Templates` | `Visual C#`(或`Visual Basic`) | `Web`菜单。

  * Select the `ASP.NET Web Application` template, give the project a name, and click OK.

  * 选择`ASP.NET Web Application`模板，输入项目名，点击“OK”按钮。

  * Select the desired ASP.NET 4.5.2 template and click OK.

  * 选择自己喜欢的ASP.NET 4.5.2模板，点击OK。

.l-sub-section
  :marked
    In this cookbook we'll select the `Empty` template with no added folders, 
    no authentication and no hosting. Pick the template and options appropriate for your project.

    本烹饪宝典选择了`Empty`模板，它没有添加过任何目录，没有身份验证，没有服务器托管。为你的项目选择合适的模板和选项。
    
.l-main-section
h2#copy Step 3: Copy the QuickStart files into the ASP.NET project folder

h2#copy 第三步: 拷贝“快速起步”的文件到ASP.NET项目所在的目录

:marked
  Copy the QuickStart files we downloaded from github into the folder containing the `.csproj` file.
  Include the files in the Visual Studio project as follows:

  拷贝从github下载的“快速起步”文件到包含`.csproj`文件的目录中。按照下面的步骤把它们加到Visual Studio中：
  
  * Click the `Show All Files` button in Solution Explorer to reveal all of the hidden files in the project.

  * 在Solution Explorer中点击`Show All Files`按钮，显示项目中所有隐藏文件。

  * Right-click on each folder/file to be included in the project and select `Include in Project`.
    Minimally, include the following folder/files:

  * 右键点击每个目录和文件，选择`Include in Project`。
    最少要添加下列文件：
    
    * app folder (answer *No*  if asked to search for TypeScript Typings)

    * app目录（如果询问是否要搜索TypeScript类型，回答*No*）

    * styles.css

    * styles.css

    * index.html

    * index.html

    * package.json

    * package.json

    * tsconfig.json

    * tsconfig.json

    * typings.json

    * typings.json
    
.l-main-section
h2#restore Step 4: Restore the required packages

h2#restore 第四步: 恢复需要的包

:marked
  Restore the packages required for an Angular application as follows:
  
  按下面的步骤恢复Angular应用程序需要的包：
  
  * Right-click on the `package.json` file in Solution Explorer and select `Restore Packages`.
    <br>This uses `npm` to install all of the packages defined in the `package.json` file. 
    It may take some time.

  * 在Solution Explorer中右键点击`package.json`，选择`Restore Packages`。
    <br>这样，Visual Studio会使用`npm`来安装在`package.json`中定义的所有包. 
    这可能需要花一点时间。

  * If desired, open the Output window (`View` | `Output`) to watch the npm commands execute.

  * 如果愿意，打开Output窗口(`View` | `Output`)来监控npm命令的执行情况。
  
  * Ignore the warnings.

  * 忽略所有警告。

  * When the restore is finished, a message should say: `npm command completed with exit code 0`.

  * 当恢复完成后，将会出现一条消息：`npm command completed with exit code 0`.

  * Click the `Refresh` icon in Solution Explorer.

  * 在Solution Explorer里，点击`Refresh`图标。

  * **Do not** include the `node_modules` folder in the project. Let it be a hidden project folder.

  * **不要**将`node_modules`目录添加到项目中，让它隐藏。
      
.l-main-section
h2#build-and-run Step 5: Build and run the app

h2#build-and-run 第五步：构建和运行应用

:marked
  First, ensure that `index.html` is set as the start page.
  Right-click `index.html` in Solution Explorer and select option `Set As Start Page`.

  首先，确认`index.html`已被设置为开始页面。
  在Solution Explorer中，右键点击`index.html`，选择选项`Set As Start Page`。
  
  Build and launch the app with debugger by clicking the **Run** button or press `F5`.

  点击**Run**按钮或者按`F5`键，用调试器构建和启动应用。
.l-sub-section
  :marked
    It's faster to run without the debugger by pressing `Ctrl-F5`.

    按`Ctrl-F5`不带调试器的运行应用，速度会更快。
:marked
  The default browser opens and displays the QuickStart sample application.

  默认浏览器打开并显示快速开始例子应用。
  
  Try editing any of the project files. *Save* and refresh the browser to
  see the changes. 

  尝试编辑任何项目文件，*保存*并刷新浏览器来查看效果。

.l-main-section
h2#routing Note on Routing Applications

h2#routing 应用程序的路由

:marked
  If this application used the Angular router, a browser refresh could return a *404 - Page Not Found*.
  Look at the address bar. Does it contain a navigation url (a "deep link") ... any path other than `/` or `/index.html`?
   
  如果这个应用程序使用了Angular路由器，刷新浏览器时可能会返回一个*404 - Page Not Found*。
  查看一下地址栏，它是否包含一个导航url（“深链接”）...以及任何除了`/`或`/index.html`以外的路径？
  
  You'll have to configure the server to return `index.html` for these requests.
  Until you do, remove the navigation path and refresh again. 
  
  我们必须配置服务器，让它为这些请求直接返回`index.html`的内容。在配置完之前，请暂时删除导航路径，回到首页，再进行刷新。

