Creating an ASP.NET MVC 3 Application

About this Tutorial –

Objectives –

Delegates will learn to develop applications using C #3.0 After completing this course, delegates will be able to:

  • Use Visual Studio 2010 effectively
  • Creating an ASP.NET MVC 3 Application

Audience

This course has been designed primarily for programmers new to the .Net development platform. Delegates experience solely in Windows application development or earlier versions of ASP.Net will also find the content beneficial.

Prerequisites

Before attending this workshop, students must:

  • Be able to manage a solution environment using the Visual Studio 2010 IDE and tools
  • Be able to program an application using a .NET Framework 3.0 compliant language

Contents

Copyright 20/12/12 – David Ringsell

Download Solutions

Java tutorial

Overview

In these labs, you’ll create an ASP.NET MVC3 web application that allows the user to register their details.


Index View

  1. Page 1 will ask the user to enter their name. The page will have a “Next” button that shows page 2.
  2. Page 2 will ask the user for their details: username, password and email address.
  3. Page 3 will confirm the user’s details. The page will have a hyperlink to return to page 1.

How about a training course? View Course Outline.

Lab 1: Creating The First Page

Create an empty ASP.NET MVC3 web application named Registration using C#. Implement the first page.


An MVC3 Applcation

  1. Add a controller class named HomeController to the Controllers folder. To do this right-click and select Add>Controller from the context menu. Add a standard action method named Index() that returns the default view to this controller.

    In an MVC application all of the browser’s HTTP requests are handled first by a Controller class. This class contains action methods that the requests are directed to. The specific controller and method that is invoked will depend on the request’s URL.

  2. Add an ASPX view for the Index() action method. To do this right-click in the Index() method and select Add View … from the context menu. This will cause a web page named Index.aspx to be added in the Views/Home folder.

    In an MVC application a view holds only the visual content of the web page.

  3. Open Index.aspx in the Views\Home folder.
  4. Add a < using(Html.BeginForm()){ %> tag, to start a form in Index.aspx.
  5. Within the form, include the Html.TextBox() HTML helper function to display a text box named username. HTML helper functions make it easier to add HTML tags to a view by employing intellisense.
  6. Add a submit button inside the form. Use plain old HTML to do this. The submit button will post back the form back to the same action and the same controller.
  7. Use a %}%> tag to mark the end of the form.
    <body>
    <h3>Welcome to the website registration</h3>
    <% using(Html.BeginForm())
    {%>
    <%: Html.Label("Please enter your name") %>
    <%: Html.TextBox("name")%>
    <p> <input type="submit" value="Next" /> </p>
    <%}%>

    </body>
  8. View code file.
  9. Now run the application. When the page is shown, just enter your name and click the button. This submits the form back to the server, and causes MVC to call your Index() action method. Unfortunately Index() only redisplays page without your name. To solve this problem, you now need to handle the HTTP POST request so the user is redirected to the next page.
  10. Edit the Index() method in the Controller so that it only handles the initial page request. To do this adds this annotation just above the method declaration. [HttpGet]
    [HttpGet]//Run action method on first request public ActionResult Index() {
    return View();
    }


  11. Add a second action method also called Index(), to handle form submissions from the first page. To do this, add this annotation just above the method declaration.[HttpPost]
  12. This method also requires a string parameter called username, which MVC automatically populates from the textbox on the page.
  13. Now edit your new Index() method by including this statement.
    return RedirectToAction(“Details”, “Home”, new {name = name});
    This attempts to redirect the next page and it also passes the name parameter to that page.
  14. [HttpPost]//Run action method on form submission
    public ActionResult Index(string name)
    {
    return RedirectToAction("Details", "Home", new { name = name });
    }

  15. View code file.
  16. Run the application. Even though you will get a 404 Page Not Found error, this is not a problem at this stage. The error will disappear when you create the Details() action method and the Details.aspx view on the next lab.

Lab 2: Creating The User Details Page

Add a model class to hold the user details. Add a view to allow the user to enter their details.


  1. In the Models folder, create a class named UserDetails. To do this right-click and select Add>Class … from the context menu.

    In an MVC application a Model class contains all the business, validation and data access code. Since the Model classes are clearly separate from the application’s Controllers and Views, they can be implemented, tested & maintained independently.

  2. Add properties of type string for name, username, password and email address.
    public class UserDetails
    {
    public string Name { get; set; }
    public string UserName { get; set; }
    public string Password { get; set; }
    public string EmailAddress { get; set; }
    }
    }
  3. View code file.
  4. In the controller class, add an action method named Details(). This handles HTTP GET requests to display the Details view.
  5. Include a string parameter to hold the name in the Details() method. The parameter will be passed in from the first page.
  6. Inside the method, create a new UserDetails object and set its Name property to the incoming name parameter.
  7. Add this statement to return the default view: return View(user);
  8. [HttpGet]//Run action method on first request
    public ActionResult Details(string name)
    {
    UserDetails user = new UserDetails();
    user.Name = name;
    return View(user);
    }

  9. View code file.
  10. This passes an UserDetails object as the model parameter to the view.
  11. Add an ASPX view for the Details() action method. Make the view a strongly-typed view, based on the UserDetails class. This will add a Web page named Details.aspx to the Views/Home folder.
  12. Implement Details.aspx to display the name entered on the first page in a heading.
  13. In Details.aspx also display a form containing text boxes. These allow the user to enter their details. Use Html.TextBoxFor() for each text box.
  14. At the bottom of Details.aspx add a submit button.
    <body>
    <h3>Hi <%: Model.Name %></h3>
    Please enter your registration details
    <div>
    <% Html.EnableClientValidation(); %>
    <% using(Html.BeginForm())
    {%>
    <p>
    <%: Html.LabelFor(m => m.UserName, "User Name:")%>
    <%: Html.TextBoxFor(m => m.UserName)%>
    </p>
    <p>
    <%: Html.LabelFor(m => m.Password, "Password:")%>
    <%: Html.TextBoxFor(m => m.Password)%>
    </p>
    <p>
    <%: Html.LabelFor(m => m.EmailAddress, "Email Address:")%>
    <%: Html.TextBoxFor(m => m.EmailAddress)%>
    </p>
    <p> <input type="submit" value="Next" /> </p>
    <%}%>
    </div>
    </body>
  15. View code file.
  16. Back in the controller class, implement another action method named Details() to handle HTTP POST requests.
  17. The method takes a UserDetails parameter. MVC will populate this object automatically with the data entered in each text box.
  18. Return a view specifying “Confirmation” as the view name. Pass the UserDetails object as the model parameter to the view. The view does not yet exist.
    [HttpPost]//Run action method on form submission
    public ActionResult Details(UserDetails user)
    {
    return View("Confirmation", user);
    }
  19. Run the application. In the first page, enter your name and click the submit button. Verify that the “user details” page now appears, displaying your name and a series of text boxes. Enter some details and then click the submit button. At this stage you will receive an ASP.NET error indicating the “Confirmation” view cannot be found. You will create this in the next lab.

. Lab 3: Creating the Confirmation Page

Add a view to confirm the user has entered their details.


Confirmation View

  1. For the HTTP-POST version of the Details() action method, then add an ASPX view named Confirmation that is strongly bound to the UserDetails class. Make the view a strongly-typed view, based on the UserDetails class.
  2. Implement Confirmation.aspx so that it shows the user information.
  3. Add a hyperlink at the bottom of the page to return the user to the first page. Use the Html.ActionLink() helper function.
    <body>
    <div>
    <% using(Html.BeginForm())
    {%>
    <p>You have now been registered as:</p>
    <ul>
    <li> User Name: <%: Model.UserName %> </li>
    <li> Password: <%: Model.Password%> </li>
    <li> Email Address: <%: Model.EmailAddress %> </li>
    </ul>
    <p> <%: Html.ActionLink("Return to welcome page", "Index")%>
    </p>
    <%}%>
    </div>
    </body>
  4. View code file.
  5. Run the application. Is it now working fully?

Lab 4 Add Validation

Add validation checks when user details are entered.

  1. Include validation in the model class. Add attributes to the properties that define the checks. Use attributes in the System.ComponentModel.DataAnnotations namespace, such as [Required], [StringLength], and [Range].
    [Required(ErrorMessage = "Name required")]
    public string Name { get; set; }
  2. In the Details page, do not proceed if there are any validation errors.
    [HttpPost]//Run action method on form submission public
    ActionResult Details(UserDetails user)
    {
    if (ModelState.IsValid)
    return View("Confirmation", user);
    else
    return View(user);
    }

  3. View code file.
  4. Enable client-side validation In the Details page. Add this statement before the start of the form: <%Html.EnableClientValidation();%>

Back to beginning

If you liked this post, please comment with your suggestions to help others.
If you would like to see more content like this in the future, please fill-in our quick survey.
Scroll to Top