AspNetCore.Docs/mvc/getting-started/first-mvc-app/start-mvc.rst

64 lines
3.2 KiB
ReStructuredText

Getting started with ASP.NET MVC 6
==================================================
By `Rick Anderson`_
This tutorial will teach you the basics of building an ASP.NET MVC 6 web app using `Visual Studio 2015 <http://go.microsoft.com/fwlink/?LinkId=532606>`__.
Sections
^^^^^^^^^^^^^^^^
- `Install Visual Studio and ASP.NET`_
- `Create a web app`_
Install Visual Studio and ASP.NET
--------------------------------------
Visual Studio is an IDE (integrated development environment) for building apps. Similar to using Microsoft Word to write documents, you'll use Visual Studio to create web apps.
Install `ASP.NET 5 and Visual Studio 2015 <http://docs.asp.net/en/latest/getting-started/installing-on-windows.html>`__.
Create a web app
--------------------------------------
From the Visual Studio **Start** page, tap **New Project**.
.. image:: start-mvc/_static/new_project.png
Alternatively, you can use the menus to create a new project. Tap **File > New > Project**.
.. image:: start-mvc/_static/alt_new_project.png
Complete the **New Project** dialog:
- In the left pane, tap **Web**
- In the center pane, tap **ASP.NET Web Application**
- Name the project "MvcMovie" (It's important to name the project "MvcMovie" so when you copy code, the namespace will match. )
- Tap **OK**
.. image:: start-mvc/_static/new_project2.png
In the **New ASP.NET Project - MvcMovie** dialog, tap **Web Application**, and then tap **OK**.
.. image:: start-mvc/_static/p3.png
Visual Studio used a default template for the MVC project you just created, so you have a working app right now by entering a project name and selecting a few options. This is a simple "Hello World!" project, and it's a good place to start,
Tap **F5** to run the app in debug mode or **Ctl-F5** in non-debug mode.
.. image:: start-mvc/_static/1.png
- Visual Studio starts `IIS Express <http://www.iis.net/learn/extensions/introduction-to-iis-express/iis-express-overview>`__ and runs your app. Notice that the address bar shows ``localhost:port#`` and not something like ``example.com``. That's because ``localhost`` always points to your own local computer, which in this case is running the app you just created. When Visual Studio creates a web project, a random port is used for the web server. In the image above, the port number is 1234. When you run the app, you'll see a different port number.
- Launching the app with **Ctl-F5** (non-debug mode) allows you to make code changes, save the file, refresh the browser, and see the code changes. Many developers prefer to use non-debug mode to quickly launch the app and view changes.
- You can launch the app in debug or non-debug mode from the **Debug** menu item:
.. image:: start-mvc/_static/debug_menu.png
- You can debug the app by tapping the **IIS Express** button
.. image:: start-mvc/_static/iis_express.png
Right out of the box the default template gives you Home, Contact, About, Register and Log in pages. The browser image above doesn't show theses links. Depending on the size of your browser, you might need to click the navigation icon to show them.
.. image:: start-mvc/_static/2.png
In the next part of this tutorial, we'll learn a about MVC and start writing some code.