ASP.NET MVCルーティングの詳細な紹介-C#.Net チュートリアル-php.cn

デフォルトルートテーブルについて

新しい ASP.NET MVC アプリケーションを作成すると、アプリケーションは ASP.NET ルーティングを使用するようにすでに 2 つの場所で設定されています。

最初のポイントは、アプリケーションの Web構成ファイル (Web.config ファイル) で ASP.NET ルーティングを有効にすることです。構成ファイルには、ルーティングに関連する 4 つのノードがあります: sytem.web.httpModule セクション、system。 web.httpHandlers セクション、system.webserver.modules セクション、および system.webserver.handlers セクション。これらのノードがないとルーティングが機能しないため、これらのノードを削除しないように特に注意してください。

2 番目のポイント、そしてより重要なポイントは、アプリケーションの Global.asax ファイルにルーティングテーブルを作成することです。 Global.asax ファイルは、ASP.NET アプリケーションの動作に影響を与える情報を含む特別なファイルです。 . 定期的なイベントのイベントハンドラー。ルーティングテーブルは、アプリケーションの開始イベント中に作成されます。

リスト 1 のファイルには、ASP.NET MVC アプリケーションのデフォルトの Global.asax ファイルが含まれています。

コードリスト 1 - Global.asax.cs

使用系统; 
使用 System.Collections.Generic; 
使用 System.Linq; 
使用 System.Web; 
使用 System.Web.Mvc; 
使用 System.Web.Routing; 
命名空间 MvcApplication1
{
    //注意：有关启用IIS6或IIS7经典模式的说明，
    请访问http://go.microsoft.com/?LinkId=9394801 
    public class MvcApplication：System.Web.HttpApplication
    {
        public static void RegisterRoutes（RouteCollection路由）
        {
            routes.IgnoreRoute（ “{resource} .axd / {* pathInfo}”）; 
            路线。
                MapRoute（ “Default”，                                              // Route name 
                “{controller} / {action} / {id}”，                           //具有参数
                的URL new {controller = “Home”，action =“Index”，id =“” } //参数默认值
            ）; 
        }
        protected void Application_Start（）
        {
            RegisterRoutes（RouteTable.Routes）; 
        }
    }
} //具有参数的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults）; } protected void Application_Start（）{RegisterRoutes（RouteTable.Routes）; }}} //具有参数的URL new {controller = “Home”，action =“Index”，id =“” }  //参数defaults）; } protected void Application_Start（）{RegisterRoutes（RouteTable.Routes）; }}} } protected void Application_Start（）{RegisterRoutes（RouteTable.Routes）; }}} } protected void Application_Start（）{RegisterRoutes（RouteTable.Routes）; }}}

ログイン後にコピー

MVC アプリケーションが初めて実行されるとき、Application_Start() メソッドが呼び出されます。次に、このメソッドは RegisterRoutes() メソッドを呼び出し、ルーティングテーブルを作成します。

デフォルトルートテーブルには 1 つのルート (デフォルトという名前) が含まれています。DEFAULT ルートは、URL の最初の部分を controller 名にマップし、URL の 2 番目の部分をコントローラアクションにマップし、3 番目の部分をというルートにマップします。 IDパラメータ。

ブラウザのアドレスバーに次の URL を入力するとします:

/Home/Index/3

デフォルトルートは、この URL を次のパラメータにマップします:

Controller = Home

Action = Index

id = 3

URL /Home/Index/3 をリクエストすると、次のコードが実行されます:

HomeController.Index(3)

デフォルトルートには、3 つのパラメータすべてのデフォルト値が含まれています。コントローラーを指定しない場合、コントローラーパラメーターはデフォルトでホームページに設定されます。アクションを指定しない場合、アクションパラメーターはデフォルトで値インジケーターになります。最後に、ID を指定しない場合、ID パラメーターはデフォルトで空の文字列になります。

デフォルトルーティングが URL をコントローラーアクションにマッピングする方法の例をいくつか見てみましょう。ブラウザのアドレスバーに次の URL を入力したと想像してください:

/home

デフォルトルートパラメータのデフォルト値により、次のように入力します。この URL は、リスト 2 の HomeController クラスの Index() メソッドを呼び出します。

コードリスト 2 - HomeController.cs

使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers 
{ 
    [HandleError] 
    public class HomeController：Controller 
    { 
        public ActionResult Index（string id）
        { 
            return View（）; 
        } 
    } 
}

ログイン後にコピー

コードリスト 2 では、HomeController クラスに Index() というメソッドが含まれており、このメソッドは Id というパラメーターを受け取ります。URL /Home によって Index() メソッドが呼び出されます。そして、Idパラメータの値として空の文字列を作成します。

MVC フレームワークがコントローラーアクションを呼び出す方法により、URL /Home はリスト 3 の HomeController クラスの Index() メソッドとも一致します。

コードリスト 3 - HomeController.cs (パラメーターなしのインデックスアクション)

使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers 
{ 
    [HandleError] 
    public class HomeController：Controller 
    { 
        public ActionResult Index（）
        { 
            return View（）; 
        } 
    } 
}

ログイン後にコピー

コードリスト 3 の Index() メソッドはパラメーターを受け入れません。URL/Home によって、この Index() メソッドが呼び出されます。URL/ Thisこのメソッドは Home/Index/3 に対しても呼び出されます (ID は無視されます)。

URL /Home は、リスト 4 の HomeController クラスの Index() メソッドとも一致します。

コードリスト 4 - HomeController.cs (null 許容パラメーターを使用したインデックスアクション)

使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers 
{ 
    [HandleError] 
    public class HomeController：Controller 
    { 
        public ActionResult Index（int？id）
        { 
            return View（）; 
        } 
    } 
}

ログイン後にコピー

コードリスト 4 では、index() メソッドに integer パラメーターがあります。このパラメーターは null 許容パラメーター (null 値を持つことができる) であるため、エラーをスローせずに exponent() を呼び出すことができます。

最後に、URL /Home を使用してリスト 5 の Index() メソッドを呼び出すと、Id パラメーターが null 許容パラメーターではないため、例外がスローされます。 Index() メソッドを呼び出そうとすると、図 1 に示すようなエラーが発生します。

コードリスト 5 - HomeController.cs (Id パラメーターを使用したインデックスアクション)

使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers 
{ 
    [HandleError] 
    public class HomeController：Controller 
    { 
        public ActionResult Index（int id）
        { 
            return View（）; 
        } 
    } 
}

ログイン後にコピー

01 (1).jpg

図 01: パラメーター値を期待するコントローラーアクションの呼び出し

一方、URL /Home/Index/3 は次のことができます。リスト 5 のインデックスコントローラーアクションは正常に動作します。/Home/Index/3 に対するリクエストにより、ID 値 3 を指定して Index() メソッドが呼び出されます。

このチュートリアルの目的は、ASP.NET ルーティングについて簡単に紹介することです。新しい ASP.NET MVC アプリケーションを作成するときに取得されるデフォルトのルーティングテーブルを詳しく調べました。デフォルトのルーティングテーブルが URL をコントローラーのアクションにマッピングする方法を学習しました。

2.创建自定义路由

在这篇教程中，你会学习到如何为ASP.NET MVC应用程序添加自定义路由。你会学习如何将Global.asax文件中的默认路由表修改为自定义路由。

对于简单的ASP.NET MVC应用程序，默认的路由表已经可以很好的完成工作了。然而，你可以发现会存在特定的路由需求在这种情况下，你可以创建一个自定义路由。

设想一下，举个例子，你正在创建一个博客应用程序你可能想要像这样处理即将到来的请求：

/存档/ 2009年12月25日

当用户输入这一请求，你想要返回对应于日期2009年12月25日的博客条目。为了处理这种类型的请求，你需要创建一个自定义路由。

代码清单1中的Global.asax包含了一个新的自定义路由，命名为了博客，它处理了类似/存档/条目日期这样的请求。

代码清单1 - Global.asax（含有自定义路由）

使用 System.Web.Mvc; 
使用 System.Web.Routing; 
命名空间 MvcApplication1 
{ 
    public class MvcApplication：System.Web.HttpApplication 
    { 
        public static void RegisterRoutes（RouteCollection routes）
        { 
            routes.IgnoreRoute（“{resource} .axd / {* pathInfo}”）; 
            routes.MapRoute（
                “Blog”，                                           //路由名称
                “Archive / {entryDate}”，                            //具有参数
                的URL new {controller = “Archive”，action =“ } //参数defaults
            ）; 
            routes.MapRoute（
                “Default”，//路由名称
                “{controller} / {action} / {id}”，//具有参数
                的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults
            ）; 
        } 
        protected void Application_Start（）
        { 
            RegisterRoutes（RouteTable.Routes）; 
        } 
    } 
} }  //参数defaults）; routes.MapRoute（“Default”，//路由名称“{controller} / {action} / {id}”，//具有参数的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults）; } protected void Application_Start（）{ RegisterRoutes（RouteTable.Routes）; } } } ，//路由名称“{controller} / {action} / {id}”，//具有参数的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults）; } protected void Application_Start（）{ RegisterRoutes（RouteTable.Routes）; } } } ，                                              //路由名称“{controller} / {action} / {id}”，                           //具有参数的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults）; } protected void Application_Start（）{ RegisterRoutes（RouteTable.Routes）; } } } //具有参数的URL new {controller = “Home”，action =“Index”，id =“” } //参数defaults）; } protected void Application_Start（）{ RegisterRoutes（RouteTable.Routes）; } } } //具有参数的URL new {controller = “Home”，action =“Index”，id =“” }  //参数defaults）; } protected void Application_Start（）{ RegisterRoutes（RouteTable.Routes）; } } }

ログイン後にコピー

添加到路由表中的路由顺序非常重要。我们的新自定义博客路由在现有的默认路由前面。如果你将这个顺序颠倒过来，那么默认路由将总是被调用，而不是自定义路由。

自定义博客路由匹配任何以/存档/作为开始的请求因此，它匹配所有下面的网址：

/存档/ 2009年12月25日

/存档/ 2004年10月6日

/存档/苹果

自定义路由将即将到来的请求映射到名为存档的控制器，并且调用了条目（）动作。当调用项（）方法时，条目日期作为entryDate参数进行了传递。

代码清单2 - ArchiveController.cs

使用系统; 
使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers
{
    public class ArchiveController：Controller
    {
        public string Entry（DateTime entryDate）
        {
            return “您从” + entryDate.ToString（））请求了条目。
        }
    }
}

ログイン後にコピー

注意到代码清单2中的条目（）方法接受一个日期时间类型的参数.MVC框架非常的聪明，足以自动地将URL中的条目日期转换为日期时间值。如果URL中的条目日期参数不能转换为日期时间，将会引发错误（如图1）。

图1 - 转换参数时的错误

02 (1).jpg

这篇教程的目的是演示如何创建自定义路由。你学习了如何在Global.asax中文件的路由表中添加自定义路由，该路由代表着博客条目。我们讨论了如何将对博客条目的请求映射到名为ArchiveController的控制器，和名为项（）的控制器动作上。

3.创建路由约束

你可以使用路由约束来限制匹配特定路由的浏览器请求。可以使用正则表达式来指定一个路由约束。

举个例子，假设你已经在Global.asax中文件中定义了一个路由。

代码清单1 - Global.asax.cs

routes.MapRoute（
    “Product”，
    “Product / {productId}”，
    new {controller =“Product”，action =“Details”} 
）;

ログイン後にコピー

代码清单1包含一个叫做产品的路由。你可以使用产品路由将浏览器请求映射到代码清单2中的ProductController的。

代码清单2 - Controllers \ ProductController.cs

使用 System.Web.Mvc; 
命名空间 MvcApplication1.Controllers 
{ 
    public class ProductController：Controller 
    { 
        public ActionResult Details（int productId）
        { 
            return View（）; 
        } 
    } 
}

ログイン後にコピー

注意到产品控制器公布的详细信息（）动作接受一个叫做的productId的参数。这个参数是一个整数参数。

定义在代码清单1中的路由将会匹配下面的任意网址：

/产品/ 23
/产品/ 7
不幸的是，路由也会匹配下面的网址：
/产品/嗒嗒
/产品/苹果

ログイン後にコピー

因为详细（）动作期望的是一个整数值，发起一个含有非整数值的请求将会导致错误。举个例子，如果你在浏览器中输入/产品/苹果网址，那么你将会得到图1所示的错误页。

03 (1).jpg

图1：错误页

你实际想做的是只匹配包含合适整数productId参数的URL。当定义路由来限制与路由相匹配的网址时，你可以使用约束。代码3中的修改后的产品路由包含了一个正则表达式，它限制了只匹配数字。

代码清单3 - Global.asax.cs

routes.MapRoute（
    “Product”，
    “Product / {productId}”，
    new {controller =“Product”，action =“Details”}，
    new {productId = @“\ d +”} 
 ）

ログイン後にコピー

正则表达式\ D +匹配一个或多个整数这个限制使得产品路由匹配了下面的网址：

/产品/ 3
/产品/ 8999
但是不匹配下面的网址：
/产品/苹果
/产品

ログイン後にコピー

这些浏览器请求将自由另外的路由处理，或者，如果没有匹配的路由，将会返回一个“资源找不到”错误。

创建一个自定义路由约束

这篇教程的目标是演示如何创建一个自定义路由约束。自定义路由约束允许你阻止某个路径被匹配，除非满足一些自定义的条件。

在这篇教程中，我们创建了一个本地主机路由约束.Localhost路由约束只匹配本地计算机发出的请求。通过互联网发出的远程请求不会被匹配。

。你可以通过实现IRouteConstraint接口来实现一个自定义路由这是一个极其简单的接口，它只描述了一个方法：

bool Match（
    HttpContextBase httpContext，
    Route route，
    string parameterName，
    RouteValueDictionary值，
    RouteDirection routeDirection 
）

ログイン後にコピー

这个方法返回一个布尔值。如果返回了假，与约束相关联的路由将不会匹配浏览器请求。

本地主机约束包含在了代码清单1中。

代码清单1 - LocalhostConstraint.cs

使用 System.Web; 
使用 System.Web.Routing; 
命名空间 MvcApplication1.Constraints 
{ 
    public class LocalhostConstraint：IRouteConstraint 
    { 
        public bool Match 
            （
                HttpContextBase httpContext，
                Route route，
                string parameterName，
                RouteValueDictionary values，
                RouteDirection routeDirection 
            ）
        { 
            return httpContext.Request.IsLocal; 
        } 
    } 
}

ログイン後にコピー

代码清单1中的约束利用了HttpRequest的类公布的IsLocal属性。当发出请求的IP地址是127.0.0.1或者与服务器的IP地址相同时，这个属性返回真。

你在定义于Global.asax中的路由中使用了自定义约束。代码清单2中的Global.asax中文件使用了本地主机约束来阻止任何人请求管理员页面，除非他们从本地服务器发出请求。举个例子，当请求来自远程服务器时，对于/管理/ Delete All的请求将会失败。

代码清单2 - Global.asax

使用系统; 
使用 System.Collections.Generic; 
使用 System.Linq; 
使用 System.Web; 
使用 System.Web.Mvc; 
使用 System.Web.Routing; 
使用 MvcApplication1.Constraints; 
命名空间 MvcApplication1
{
    public class MvcApplication：System.Web.HttpApplication
    {
         public static void RegisterRoutes（RouteCollection routes）{
            routes.IgnoreRoute（ “{resource} .axd / {* pathInfo}”）; 
            routes.MapRoute（
                “Admin”，
                “Admin / {action}”，
                
                isLocal = new LocalhostConstraint（）} 
            ）; 
            //routes.MapRoute（
            //    “默认”，//路线名称
            //    “{控制器} / {行动} /（编号）”，// URL与参数
            //    新 {控制器= “主页”，动作=“索引“，id =”“ } //参数defaults 
            //）; 
        } 
        protected void Application_Start（）{ 
            RegisterRoutes（RouteTable.Routes）; 
        } 
    } 
}

ログイン後にコピー

本地主机约束使用在了管理路由的定义中这个路由不会被远程浏览器请求所匹配然而，应该意识到定义在Global.asax中中的其他路由可能会匹配相同的请求理解这一点很重要。：约束阻止了特定路由匹配某一请求，而不是所有定义在Global.asax中文件中的路由。

注意到默认路由在代码清单2中的Glabal.asax文件中被注释掉了。如果你包含默认路由，那么默认路由将会匹配对管理控制器的请求。在这种情况下，远程用户仍然可以调用管理控制器的动作，即使他们的请求不匹配管理路由。

【相关推荐】

1. 什么是ASP.NET MVC ？总结ASP.NET MVC

2. 详细介绍ASP.NET MVC--控制器（controller）

3. 详细介绍ASP.NET MVC--视图

4. 深入了解ASP.NET MVC与WebForm的区别

5. 通过asp.net mvc开发微信自定义菜单编辑工具的代码示例

以上がASP.NET MVCルーティングの詳細な紹介の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。