Adding a Controller (C#)

快来打我* 2022-10-10 04:53 13阅读 0赞

MVC stands for *model-view-controller*. MVC is a pattern for developing applications that are well architected and easy to maintain. MVC-based applications contain:

*  Controllers: Classes that handle incoming requests to the application, retrieve model data, and then specify view templates that return a response to the client.
 *  Models: Classes that represent the data of the application and that use validation logic to enforce business rules for that data.
 *  Views: Template files that your application uses to dynamically generate HTML responses.

We'll be covering all these concepts in this tutorial series and show you how to use them to build an application.

Let's begin by creating a controller class. In **Solution Explorer**, right-click the *Controllers* folder and then select **Add Controller**.

[![WindowsLiveWriter_AddingaController_F08A_AddController_sm_thumb.png_cdn_id_2013-08-19-002][]][WindowsLiveWriter_AddingaController_F08A_AddController_sm_thumb.png_cdn_id_2013-08-19-002 1]

Name your new controller "HelloWorldController". Leave the default template as **Empty controller** and click **Add**.

[![AddHelloWorldController][]][AddHelloWorldController 1]

Notice in **Solution Explorer** that a new file has been created named *HelloWorldController.cs*. The file is open in the IDE.

![WindowsLiveWriter_AddingaController_F08A_HelloWrldCtrl_thumb_1.png_cdn_id_2013-08-19-002][]

Inside the `public class HelloWorldController` block, create two methods that look like the following code. The controller will return a string of HTML as an example.

using System.Web;
    using System.Web.Mvc; 
     
    namespace MvcMovie.Controllers 
    {
        
        public class HelloWorldController : Controller 
        {
        
            // 
            // GET: /HelloWorld/ 
     
            public string Index() 
            {
        
                return "This is my <b>default</b> action..."; 
            } 
     
            // 
            // GET: /HelloWorld/Welcome/ 
     
            public string Welcome() 
            {
        
                return "This is the Welcome action method..."; 
            } 
        } 
    }

Your controller is named `HelloWorldController` and the first method above is named `Index`. Let’s invoke it from a browser. Run the application (press F5 or Ctrl+F5). In the browser, append "HelloWorld" to the path in the address bar. (For example, in the illustration below, it's *http://localhost:43246/HelloWorld.*) The page in the browser will look like the following screenshot. In the method above, the code returned a string directly. You told the system to just return some HTML, and it did!

![IE_helloWorld.PNG][]

ASP.NET MVC invokes different controller classes (and different action methods within them) depending on the incoming URL. The default mapping logic used by ASP.NET MVC uses a format like this to determine what code to invoke:

`/[Controller]/[ActionName]/[Parameters]`

The first part of the URL determines the controller class to execute. So */HelloWorld* maps to the `HelloWorldController` class. The second part of the URL determines the action method on the class to execute. So */HelloWorld/Index* would cause the `Index` method of the `HelloWorldController` class to execute. Notice that we only had to browse to */HelloWorld* and the `Index` method was used by default. This is because a method named `Index` is the default method that will be called on a controller if one is not explicitly specified.

Browse to *http://localhost:xxxx/HelloWorld/Welcome*. The `Welcome` method runs and returns the string "This is the Welcome action method...". The default MVC mapping is `/[Controller]/[ActionName]/[Parameters]`. For this URL, the controller is `HelloWorld` and `Welcome` is the action method. You haven't used the `[Parameters]` part of the URL yet.

![WelcomeAction.PNG][]

Let's modify the example slightly so that you can pass some parameter information from the URL to the controller (for example, */HelloWorld/Welcome?name=Scott&numtimes=4*). Change your `Welcome` method to include two parameters as shown below. Note that the code uses the C\# optional-parameter feature to indicate that the `numTimes` parameter should default to 1 if no value is passed for that parameter.

public string Welcome(string name, int numTimes = 1) {
       
         return HttpUtility.HtmlEncode("Hello " + name + ", NumTimes is: " + numTimes);
    }

Run your application and browse to the example URL (*http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4)*. You can try different values for `name` and `numtimes` in the URL. The system automatically maps the named parameters from the query string in the address bar to parameters in your method.

![numTimesParam.PNG][]

In both these examples the controller has been doing the "VC" portion of MVC — that is, the view and controller work. The controller is returning HTML directly. Ordinarily you don't want controllers returning HTML directly, since that becomes very cumbersome to code. Instead we'll typically use a separate view template file to help generate the HTML response. Let's look next at how we can do this.

[WindowsLiveWriter_AddingaController_F08A_AddController_sm_thumb.png_cdn_id_2013-08-19-002]: http://i1.asp.net/media/2578270/WindowsLiveWriter_AddingaController_F08A_AddController_sm_thumb.png?cdn_id=2013-08-19-002
[WindowsLiveWriter_AddingaController_F08A_AddController_sm_thumb.png_cdn_id_2013-08-19-002 1]: http://i3.asp.net/common/www-css/i//MVC3/MVC3_gettingStarted_CS/img/AddController.png
[AddHelloWorldController]: http://i2.asp.net/media/2578282/WindowsLiveWriter_AddingaController_F08A_AddHelloWorldController_thumb_2.png?cdn_id=2013-08-19-002
[AddHelloWorldController 1]: http://i2.asp.net/media/2578276/WindowsLiveWriter_AddingaController_F08A_AddHelloWorldController_6.png?cdn_id=2013-08-19-002
[WindowsLiveWriter_AddingaController_F08A_HelloWrldCtrl_thumb_1.png_cdn_id_2013-08-19-002]: http://i1.asp.net/media/2578288/WindowsLiveWriter_AddingaController_F08A_HelloWrldCtrl_thumb_1.png?cdn_id=2013-08-19-002
[IE_helloWorld.PNG]: http://i3.asp.net/common/www-css/i//MVC3/MVC3_gettingStarted_CS/img/IE_helloWorld.PNG
[WelcomeAction.PNG]: http://i3.asp.net/common/www-css/i//MVC3/MVC3_gettingStarted_CS/img/WelcomeAction.PNG
[numTimesParam.PNG]: http://i3.asp.net/common/www-css/i//MVC3/MVC3_gettingStarted_CS/img/numTimesParam.PNG