生成输出url

时间:2021-08-27 14:34:32

继续使用前面的例子11-3URLTestDemo,修改Global.asax中的RegisterRoutes方法如下:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

1、手工定义URL

在某些情况下可以直接手工定义url

假设在HomeController中有方法About:

        public ViewResult About()
{
return View();
}

并为它添加了对应的默认视图Views/Home/About.cshtml

@{
ViewBag.Title = "About";
} <h2>About</h2>

现在,在HomeController中有方法Index:

        public ViewResult Index(string id)
{
//ViewBag.id = RouteData.Values["id"];
ViewBag.id = id;
return View();
}

并添加了对应的视图Views/Home/Index.cshtml

@{
ViewBag.Title = "Index";
} <h2>ID: @ViewBag.id</h2>
<p>
<a href="/Home/About">About this application</a>
</p>

这里的<a href="/Home/About">About this application</a>就是手工产生了一个url,指向"~/Home/About",在本项目中任何cshtml文件直接这样编码,都可以产生一个"~/Home/About"的url,无论是否跟About在同一个控制器中、无论论是否跟About在同一层次。

2、在视图中生成输出URL(使用ActionLink)

在刚才的Views/Home/Index.cshtml中使用:

@Html.ActionLink("About this application", "About")

第一个参数是链接文本,第二个参数是生成当前视图的控制器里的目标方法名。需要注意的是,ActionLink所生成的Html是基于当前路由方案的。如果定义的路由是:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

注意,没有{*catchall},这种路由定义下,@Html.ActionLink("About this application", "About")就会正常生成Html和超链接如下:

<a href="/Home/About">About this application</a>

但是,这里有个问题尚未解决,如果路由定义是跟本文开头一样的:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}/{*catchall}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

有{*catchall},这种路由定义下,@Html.ActionLink("About this application", "About")就不能正常生成超链接,超链接是空的:

<a href="">About this application</a>

ActionLink所生成的Html是基于当前路由方案,另一个例子是,不改变视图中ActionLink的调用,通过修改路由,来生成匹配的路由的Html和超链接。

例如,修改路由定义:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("NewRoute", "App/Do{action}",
new { Controller = "Home" }); routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

那么@Html.ActionLink("About this application", "About")就会生成:

<a href="/App/DoAbout">About this application</a>

但是需注意的是,点击生成的url,按照顺序,匹配的是第一个路由定义,此时控制器仍是Home,动作方法还是About。也就是现在"~/App/DoAbout"和"~/Home/About"访问到的是同一个页面。可以通过这种方法隐藏真实的controller和action,或者说在controller和action发生变化后,可以通过这种方式来维护旧有的url。而修改路由方案后,视图中的输出链接会自动反映出这种修改。

============

使用ActionLink在视图中生成输出URL(注意生成什么样的url)

(1)假如路由是如下定义:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

在Views/Home/Index.cshtml中使用:

@Html.ActionLink("About this application", "About")

首先,需要知道使用ActionLink的视图是由哪个控制器产生的。这里使用ActionLink的Index.cshtml视图,是由控制器Home中的Index动作方法产生的默认视图。当我们在Index.cshtml视图中使用ActionLink时,它的第一个参数给出了超链接文本,第二个参数给出了目标Aciton,并没有给出目标Controller,这时使用的目标控制器,就是产生当前视图的控制器Home。也就是说,生成的url被点击后,要访问的就是Home控制器里的About动作方法。分析出目标控制器和动作方法后,再将其跟定义的路由进行匹配,反向推导出如果要访问这样的控制器和动作方法,那么它的url地址应该是什么形态。本例中目标Controller为Home,目标Action为About,目标id没有,因为id设置有UrlParameter.Optional属性,所以没有给出id的值时,就没有id变量。而控制器和动作方法在url模式中都有显式变量{controller}和{action}。因此,用控制器的值Home,和动作方法的值About,id变量没有就表示没有值,反推回去,得到生成的url为"~/Home/About"

(2)假设对于跟上面相同的路由定义,在Views/Account/LogOn.cshtml中使用:

@Html.ActionLink("About this application", "About")

这里使用ActionLink的视图是由控制器Account产生的,因此,这里的ActionLink产生的目标控制器是Account,目标动作方法是About,没有id。匹配路由,反向还原路由定义中的url模式{controller}/{action}/{id},得到生成的url为"~/Account/About"

(3)修改路由定义为:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("NewRoute", "App/Do{action}",
new { Controller = "Home" }); routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

在Views/Home/Index.cshtml中使用:

@Html.ActionLink("About this application", "About")

使用ActionLink的视图由控制器Home产生,因此,ActionLink生成的目标控制器为Home,目标动作方法为About。有两条路由的定义,按照顺序,先看第一条是否匹配。第一条路由的url模式"App/Do{action}"中,没有出现变量"{controller},那么控制器变量就成为了匿名类型,反向还原生成url时,只有Controller的值等于"Home",才匹配这条路由。而当前ActionLink生成的目标控制器为Home,目标动作方法为About,跟第一条路由匹配,反向还原url,将动作方法的值About带入动作方法变量{action},得到生成的url为"~/App/DoAbout"。

当用户点击生成后的url"~/App/DoAbout"时,它又正向匹配第一个路由,解析出目标Controller为Home,目标Action为About。点击此url后,执行HomeController里的About动作方法。

(4)对于跟(3)相同的路由定义,在Views/Account/LogOn.cshtml中使用:

@Html.ActionLink("About this application", "About")

LogOn.cshtml视图由控制器Account产生,因此,ActionLink生成的目标控制器为Account,目标动作方法为About。对定义的两条路由,首先试图跟第一条路由匹配,但是不匹配,因为第一条路由在反向匹配时,只有当控制器为Home时才匹配。

所以,本次ActionLink产生的结果匹配第二条路由,反向还原,得到生成的url为"~/Account/About"

3、使用ActionLink,同时指定Action和Controller

在Views/Home/Index.cshtml中使用:

@Html.ActionLink("LogOn", "LogOn", "Account")

多加一个参数,第三个参数表示指定的控制器。生成的url为"~/Account/LogOn"

4、使用ActionLink传递除了Action和Controller以外的值

HomeController里有方法Index:

        public ViewResult Index(string id)
{
ViewBag.id = id;
return View();
}

Views/Home/Index.cshtml定义如下:

@{
ViewBag.Title = "Index";
} <h2>ID: @ViewBag.id</h2>
<p>
@Html.ActionLink("Index with id", "Index", new { id="ABC"})
</p>

(1)

如果路由定义为:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

则@Html.ActionLink("Index with id", "Index", new { id="ABC"})生成的url为"~/Home/Index/ABC"

(2)

如果路由定义为:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("NewRoute", "App/Do{action}",
new { Controller = "Home" }); routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

则@Html.ActionLink("Index with id", "Index", new { id="ABC"})生成的url为"~/App/DoIndex?id=ABC"

另,当给属性提供的值与片段变量不一致时,这些值将作为查询字符串被添加到生成的输出url上。假设路由定义与(1)相同,在Views/Home/Index.cshtml中有@Html.ActionLink("Extra value", "About", new { id="ABC", myVariable="MyValue"})

生成的url为"~/Home/About/ABC?myVariable=MyValue"

5、指定html标签属性

使用ActionLink生成url,可以指定标签属性,只需要通过new建立一个匿名类型(匿名的类型是指在路由定义的url模式中,没有对应的片段变量),新建的匿名类型内给出的属性名与所需要的标签属性名相同即可。

例如,对于路由定义:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

在Views/Home/Index.cshtml中使用ActionLink:

@Html.ActionLink("HyperLink with attribute", "Index", "Home", null, new { id="myAnchorID", @class = "myCSSClass" })

注意这里的几个参数,null表示除了前面"Index"和"Home"对应的片段变量外,后面的片段变量都没有值。

最后一个参数用new新建了匿名类型,具有id和class属性,生成的html:

<a class="myCSSClass" href="/" id="myAnchorID">HyperLink with attribute</a>

这样,当前标签<a>的样式效果就可以由myCSSClass来决定。

6、ActionLink生成全限定url

@Html.ActionLink("HyperLink with attribute", "Index", "Home", "https", "myserver.mydomain.com", "myFragmentName", new{id="MyId"}, new { id="myAnchorID", @class = "redlink" })

生成的html为:

<a class="myCSSClass" href="https://myserver.mydomain.com/Home/Index/MyId#myFragmentName" id="myAnchorID">HyperLink with attribute</a>

7、生成url字符串(而不是链接)

可以使用Url.Action方法只生成url字符串,而不生成html元素。例如:

my url is:@Url.Action("Index", "Home", new{id="MyId"})

在视图中的产生的结果为:

my url is:/Home/Index/MyId

8、也可使用RouteLink和Routeurl

@Html.RouteLink("Route Link", new { controller="Home", action="About", id="MyID" })

生成的html为:

<a href="/Home/About/MyID">Route Link</a>

也可用Url.RouteUrl来生成url字符串,而不是html元素。

@Html.RouteUrl(new { controller="Home", action="About", id="MyID" })

9、在动作方法中生成url字符串

假设有路由定义:

        public static void RegisterRoutes(RouteCollection routes)
{
routes.MapRoute("MyRoute", "{controller}/{action}/{id}",
new { Controller = "Home", Action = "Index", id = UrlParameter.Optional },
new[] { "_11_3URLTestDemo.Controllers" });
}

在HomeController.cs中有动作方法Index:

public ViewResult Index(string id)
{
ViewBag.id = id;
string myActionUrl = Url.Action("Index", new { id = "MyID" });
string myRouteUrl = Url.RouteUrl(new { Controller = "Home", action = "Index" });
return View();
}

生成url字符串,根据路由反推

myActionUrl的内容为:"/Home/Index/MyID"

myRouteUrl的内容为:"/"

10、将客户端的请求重定向到另一个url

(1)使用RedirectToAction

假设路由定义如9中所示,在HomeController.cs中有动作方法RedirectTest:

        public ActionResult RedirectTest()
{
return RedirectToAction("Index");
}

根据路由定义,反向推导,RedirectToAction("Index")生成的url是"/Home/Index"

当客户端在浏览器上请求"~/Home/RedirectTest"时,就被重定向到"~/Home/Index"

(2)使用RedirectToRoute

假设上面例子中的RedirectTest动作方法定义如下:

        public ActionResult RedirectTest()
{
return RedirectToRoute(new { controller="Home", Action="Index", id="MyID"});
}

RedirectToRoute(new { controller="Home", Action="Index", id="MyID"})生成的url是"/Home/Index/MyID"

11、用指定的路由定义来生成url

路由是按其定义的顺序,从上往下依次匹配的。在生成输出url时,根据路由定义反向推导出url,也是按路由定义顺序,从上往下进行匹配。例如,当路由定义如下时:

routes.MapRoute("MyRoute", "{controller}/{action}");

routes.MapRoute("MyOtherRoute", "App/{action}", new{ controller="Home" });

如果按照这样的顺序,那么下面用ActionLink:

@Html.ActionLink("Click me", "About");

在产生输出url时,匹配的路由总是第一条MyRoute。

可以用Html.RouteLink来指定要使用的路由:

@Html.RouteLink("Click me", "MyOtherRoute", new{ action = "About" });

-lyj