Walkthrough: Creating a Basic MVC Project with Unit Tests in Visual Studio

This walkthrough shows you how to create an ASP.NET MVC application in Visual Studio. In this walkthrough, you will create and run the sample MVC application. Then you will customize the application by adding a controller and a view.

In addition, this walkthrough shows how to use test-driven development (TDD). In the walkthrough, you create a project that contains unit tests for the MVC application.

Prerequisites

In order to complete this walkthrough, you will need:

  • Microsoft Visual Studio 2008 Service Pack 1.

    Note

    Visual Studio Standard Edition and Visual Web Developer Express do not do not support unit-test projects. You can use these versions of Visual Studio to run the parts of this walkthrough that pertain to creating and running an ASP.NET MVC project. However, you will not be able to work with unit tests as described in this walkthrough.

  • ASP.NET MVC 1.0.

You can download and install the ASP.NET MVC framework in the following ways:

  • Install the framework using the Microsoft Web Platform Installer. You can download the installer from the installation page on the Microsoft Web gallery site.

  • Download the framework from the ASP.NET MVC 1.0 page on the Microsoft Download Center.

Creating a New MVC Project

To create a new MVC project

  1. On the File menu, click New Project.

    The New Project dialog box is displayed.

    Dd410597.MVC_NewProjDialog(en-us,VS.90).png

  2. In the upper-right corner, make sure that .NET Framework 3.5 is selected.

  3. Under Project types, expand either Visual Basic or Visual C#, and then click Web.

  4. Under Visual Studio installed templates, select ASP.NET MVC Web Application.

  5. In the Name box, enter MvcBasicWalkthrough.

  6. In the Location box, enter a name for the project folder.

  7. If you want the name of the solution to differ from the project name, enter a name in the Solution Name box.

  8. Select Create directory for solution.

  9. Click OK.

    The Create Unit Test Project dialog box is displayed.

    Dd410597.MVC_CreateUnitTestDialog(en-us,VS.90).png

    Note

    If you are using the Standard or Express editions of Visual Studio, the Create Unit Test Project dialog box is not displayed. Instead, the new MVC application project is generated without a test project.

  10. Select Yes, create a unit test project.

    By default, the name of the test project is the application project name with "Tests" added. However, you can change the name of the test project. By default, the test project will use the Visual Studio Unit Test framework. For information about how to use a third-party test framework, see How to: Add a Custom MVC Test Framework in Visual Studio.

  11. Click OK.

    The new MVC application project and a test project are generated. (If you are using the Standard or Express editions of Visual Studio, the test project is not created.)

Examining the MVC Project

The following illustration shows the folder structure of a newly created MVC solution.

Dd410597.MVC_FolderStructure(en-us,VS.90).png

The folder structure of an MVC project differs from that of an ASP.NET Web site project. The MVC project contains the following folders:

  • Content, which is for content support files. This folder contains the cascading style sheet (.css file) for the application.

  • Controllers, which is for controller files. This folder contains the application's sample controllers, which are named AccountController and HomeController. The AccountController class contains login logic for the application. The HomeController class contains logic that is called by default when the application starts.

  • Models, which is for data-model files such as LINQ-to-SQL .dbml files or data-entity files.

  • Scripts, which is for script files, such as those that support ASP.NET AJAX and jQuery.

  • Views, which is for view page files. This folder contains three subfolders: Account, Home, and Shared. The Account folder contains views that are used as UI for logging in and changing passwords. The Home folder contains an Index view (the default starting page for the application) and an About page view. The Shared folder contains the master-page view for the application.

If you are using an edition of Visual Studio other than Standard or Express, a test project was also generated. The test project has a Controllers folder that contains the HomeControllerTest class. This class has a unit test for each HomeController action method (Index and About).

The newly generated MVC project is a complete application that you can compile and run without change. The following illustration shows what the application looks like when it runs in a browser.

Dd410597.MVC_DefaultAppView(en-us,VS.90).png

The unit-test project is also ready to compile and run. For this walkthrough, you will add a controller with an action method and a view, and you will add a unit test for the action method.

Adding a Controller

You will now add a controller that contains logic for downloading city maps from the Microsoft Virtual Earth Web service.

To add a controller to the MVC project

  1. In Solution Explorer, right-click the Controllers folder, click Add, and then click Controller.

    The Add Controller dialog box is displayed.

    Dd410597.MVC_AddControllerDialog(en-us,VS.90).png

  2. In the Name box, type MapsController.

    The ASP.NET MVC framework requires controller names to end with "Controller", such as HomeController, GameController, or MapsController.

  3. Clear the Add action methods for Create, Update, and Details scenarios check box.

  4. Click Add.

    Visual Studio adds the MapsController class to the project and opens it in the editor.

Creating an Action-Method Stub

To apply test-driven development (TDD) techniques to this project, you should write the unit test for an action method before you write the action method itself. However, if you want your unit test to compile, you must have a stub for the planned action method, which in this walkthrough is ViewMaps.

To add an action-method stub

  1. Open or switch to the MapsController class.

  2. Replace the Index action method with the following code in order to create the ViewMaps action-method stub.

    Function ViewMaps()
        ' Add action logic here
        Throw New NotImplementedException()
    End Function
    
    public ActionResult ViewMaps()
    {
        // Add action logic here
        throw new NotImplementedException();
    }
    

Adding Unit Tests for Action Methods

Next, you will add a controller test class to the tests project. In the class, you will add a unit test for the ViewMaps action method. The unit test will fail, because the ViewMaps action-method stub throws an exception. When you finish the action method later in this walkthrough, the test will pass.

To add unit tests for the action methods

  1. In the tests project, right-click the Controllers folder, click Add, and then click New Item.

    The Add New Item dialog box is displayed.

    Dd410597.MVC_AddTestClass(en-us,VS.90).png

  2. Under Templates, select Class.

  3. In the Name text box, type MapsControllerTest.

  4. Click Add.

    Visual Studio adds the MapsControllerTest class to the test project.

  5. Open the MapsControllerTest class and enter the following code.

                                  Imports System
    Imports System.Collections.Generic
    Imports System.Text
    Imports System.Web.Mvc
    Imports Microsoft.VisualStudio.TestTools.UnitTesting
    Imports MvcBasicWalkthrough
    
    <TestClass()> _
    Public Class MapsControllerTest
        Private testContextInstance As TestContext
        '''<summary>
        '''Gets or sets the test context which provides
        '''information about and functionality for the current test run.
        '''</summary>
        Public Property TestContext() As TestContext
            Get
                Return testContextInstance
            End Get
            Set(ByVal value As TestContext)
                testContextInstance = value
            End Set
        End Property
    
        <TestMethod()> _
        Public Sub ViewMaps()
            ' Arrange
            Dim controller As MapsController = New MapsController()
    
            ' Act
            Dim result As ViewResult = controller.ViewMaps()
    
            ' Assert
            Assert.IsNotNull(result)
        End Sub
    
    End Class
    
                                  using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using Microsoft.VisualStudio.TestTools.UnitTesting;
    using System.Web.Mvc;
    using MvcBasicWalkthrough;
    using MvcBasicWalkthrough.Controllers;
    
    namespace MvcBasicWalkthrough.Tests.Controllers
    {
        [TestClass]
        public class MapsControllerTest
        {
            [TestMethod]
            public void ViewMaps()
            {
                // Arrange
                MapsController controller = new MapsController();
    
                // Act
                ViewResult result = controller.ViewMaps() as ViewResult;
    
                // Assert
                Assert.IsNotNull(result);
            }
        }
    }
    

    This code defines the unit tests for the action method that you will finish later.

  6. In Solution Explorer, select the test project and then press CTRL+F5 to run the unit tests.

    The test fails, because the ViewMaps action method currently throws an exception.

Adding Code to the Action Method

You will now add code to the MapsController class for the ViewMaps action method in order to render the Maps view.

To add code to the action method

  1. Open the MapsController class and replace the ViewMaps action-method stub with the following code in order to render the Maps view:

                                  Function ViewMaps() As ActionResult
        Return View()
    End Function
    
                                  public ActionResult ViewMaps()
    {
         return View();
    }
    
  2. Save and close the file.

Adding a View

Next, you will add a Maps view. To keep the views organized, you will first add a Maps folder under the Views folder.

To add a page-content view to the MVC project

  1. Open the MapsController class, right-click inside the ViewMaps action method, and then click Add View.

    The Add View dialog box is displayed.

    Dd410597.MVC_AddViewDialog(en-us,VS.90).png

  2. In the View name box, enter ViewMaps.aspx.

  3. Clear the Create a partial view (.ascx) check box and the Create a strongly-typed view check box.

  4. Select the Select master page check box and set the master page to ~/Views/Shared/Site.Master.

  5. Set ContentPlaceHolder ID to "MainContent".

  6. Click Add.

    The new view is added to the project in the Maps folder.

Adding Content to the View

Next, you will add content to the new view.

To add content to the view

  1. Open ViewMaps.aspx and add the following content inside the Content element:

    <h2>My City Maps</h2>
    Select map: 
    <select onclick="GetMap(value);">
        <option value="Seattle">Seattle, WA</option>
        <option value="LasVegas">Las Vegas, NV</option>
        <option value="SaltLake">Salt Lake City, UT</option>
        <option value="Dallas">Dallas, TX</option>
        <option value="Chicago">Chicago, IL</option>
        <option value="NewYork">New York, NY</option>
        <option value="Rio">Rio de Janeiro, Brazil</option>
        <option value="Paris">Paris, France</option>
        <option value="Naples">Naples, Italy</option>
        <option value="Keta">Keta, Ghana</option>
        <option value="Beijing">Beijing, China</option>
        <option value="Sydney">Sydney, Australia</option>
    </select>
    <br />
    <br />
    <div id='earthMap' style="position:relative; width:400px; height:400px;">
    </div>
    <script charset="UTF-8" type="text/javascript" 
        src="https://dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.2&mkt=en-us">
    </script>
    <script type="text/javascript">
        var map = null;
        var mapID = '';
    
        function GetMap(mapID)
        {
            switch (mapID)
            {
                case 'Seattle':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(47.6, -122.33), 10 ,'i', true);
                    break;
                case 'LasVegas':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(36.17, -115.14), 10 ,'i' ,true);
                    break;
                case 'SaltLake':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(40.75, -111.89), 10 ,'i' ,true);
                    break;
                case 'Dallas':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(32.78, -96.8), 10 ,'i' ,true);
                    break;
                case 'Chicago':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(41.88, -87.62), 10 ,'i' ,true);
                    break;
                case 'NewYork':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(40.7, -74), 10 ,'i' ,true);
                    break;
                case 'Rio':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(-22.91, -43.18), 10 ,'i' ,true);
                    break;
                case 'Paris':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(48.87, 2.33), 10 ,'i' ,true);
                    break;
                case 'Naples':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(40.83, 14.25), 10 ,'i' ,true);
                    break;
                case 'Keta':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(5.92, 0.983), 10 ,'i' ,true);
                    break;
                case 'Beijing':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(39.91, 116.39), 10 ,'i' ,true);
                    break;
                case 'Sydney':
                    map = new VEMap('earthMap');
                    map.LoadMap(new VELatLong(-33.86, 151.21), 10 ,'i' ,true);
             }
        }   
    </script>
    

    This markup defines a drop-down list for selecting a map and the JavaScript logic for retrieving the selected map from the Microsoft Virtual Earth Web service.

  2. Save and close the file.

Adding a Tab to the Master-Page Menu

You will now add an item to the master-page menu that calls the ViewMaps action method.

To add a tab to the master-page menu

  1. In the Shared folder, open the Site.master file and locate the unordered list (ul element) in the div element whose ID is "menucontainer".

  2. Add the following code to the list between the Index and About Us tabs:

                        <li><%= Html.ActionLink("My City Maps", "ViewMaps", "Maps")%></li>
    

    The ActionLink method is a helper method that links to an action method. It takes the following parameters: the text for the link, the name of the action method, and the name of the controller.

  3. Save and close the file.

Testing the MVC Application

You can now test the application.

To test the MVC application

  1. On the Test menu, click Run, and then click All Tests in Solution.

    The results are displayed in the Test Results window. This time the tests pass.

  2. In Solution Explorer, select the walkthrough project and press CTRL+F5 to run the application.

    The Index.aspx page is displayed, which includes the tabs that are defined in the master page.

  3. Click the My City Maps tab.

    The My City Maps page is displayed. Select any map to see it displayed.

    Dd410597.MVC_MapsView(en-us,VS.90).png

Next Steps

This walkthrough gives you a first look at creating an MVC application and working with unit tests in ASP.NET MVC. From here, you might want to learn more about the ASP.NET MVC framework. The following list suggests topics for additional learning.

See Also

Tasks

How to: Add a Custom MVC Test Framework in Visual Studio

Other Resources

ASP.NET Model View Controller (MVC)

ASP.NET MVC Overview