MVC Razor模板引擎 @RenderBody、@RenderPage、@RenderSection及Html.RenderPartial、Html.RenderAction
MVC Razor模板引擎 @RenderBody、@RenderPage、@RenderSection及Html.RenderPartial、Html.RenderAction
一、Views文件夹 -> Shared文件夹下的 _Layout.cshtml 母版页
@RenderBody
当创建基于_Layout.cshtml布局页面的视图时，视图的内容会和布局页面合并，而新创建视图的内容会通过_Layout.cshtml布局页面的@RenderBody()方法呈现在标签之间。
@RenderPage
从名称可以猜出来这个方法是要呈现一个页面。比如网页中固定的头部可以单独放在一个共享的视图文件中，然后在布局页面中通过这个方法调用，用法如下：
@RenderPage(“~/Views/Shared/_Header.cshtml”)
带参数
@RenderPage(“~/Views/Shared/_Header.cshtml”,new{parm="my",parm2="you")
调用页面获取参数：
//获取 RenderPage() 传递过来的参数
@PageData["param"]
@RenderSection
布局页面还有节（Section）的概念，也就是说，如果某个视图模板中定义了一个节，那么可以把它单独呈现出来
为了防止因缺少节而出现异常，可以给RenderSection()提供第2个参数：
@RenderSection("head", false)
或
@if (IsSectionDefined("head"))
{
@RenderSection("head", false)
}
else
{
<p>SubMenu Section is not defined!</p>
}
代码如下：
- <!DOCTYPE html>
- <html>
- <head>
- <title>@ViewBag.Title</title>
- <link href="@Url.Content("~/Content/Site.css")" rel="stylesheet" type="text/css" />
- <script src="@Url.Content("~/Scripts/jquery-1.4.4.min.js")" type="text/javascript"></script>
- @RenderSection("head", required: true)@*View页面自定义特定js/css使用*@
- </head>
- <body>
- @RenderPage("~/Views/Shared/_Header.cshtml")
- @RenderBody()
- </body>
- </html>
二、创建视图，使用母版页
代码如下：
- @{
- ViewBag.Title = "Index";
- Layout = "~/Views/Shared/_Layout.cshtml";
- }
- <h2>Index</h2>
- @section Head{
- <script type="text/javascript">
- $(function () {
- alert("hello jquery");
- });
- </script>
- }
- <p>执行C#普通语法</p><br />
- @DateTime.Now.Date.ToShortDateString()
- <p>执行C#语句段</p>
- @{
- List<string> list = new List<string> { "Mvc3", "Razor" };
- list.Add(".Net4");
- }
- <ul>
- @foreach(string s in list)
- {
- if (string.IsNullOrEmpty(s))
- {
- <li>空</li>
- }
- else
- {
- <li>@s</li>
- }
- }
- </ul>
三、生成页面的源代码
<!DOCTYPE html>
<html>
<head>
<title>Index</title>
<link href="/Content/Site.css" rel="stylesheet" type="text/css" />
<script src="/Scripts/jquery-1.4.4.min.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
alert("hello jquery");
});
</script>
</head>
<body>
<h2>Index</h2>
<p>执行C#普通语法</p><br />
2013/3/11
<p>执行C#语句段</p>
<ul>
<li>Mvc3</li>
<li>Razor</li>
<li>.Net4</li>
</ul>
</body>
</html>
四、@Html.Partial
Partial 每次都会创建自己的 TextWriter 实例并且把内容缓存在内存中. 最后把所有 writer输出的内容发送到一个 MvcString对象中
更多时候我们会使用 @{ Html.RenderPartial("Details"); } 而不是@Html.Partial
Html.RenderPartial()与@Html.Partial的区别
Html.RenderPartial 直接输出至当前 HttpContext（因为是直接输出，所以性能好）。
Html.Partial 将视图内容直接生成一个字符串并返回（相当于有个转义的过程）。
RenderPage()和RenderPartial()的区别
RenderPage()调用的页面只能使用其传递过去的数据。
而RenderPartial()是可以使用viewdata,model等数据的。
如：@{Html.RenderPartial("BasicChart",model);}
用这个重载可以在部分视图里使用强类型，然后在主视图中使用第二个参数传model过去
@{Html.RenderPartial("BasicChart",ViewData["myData"]);}
Html.RenderPartial和Html.RenderAction的区别
Html.RenderPartial适合用在重覆使用的UserControl，并且只需要透过Model来呈现内容，或是对于广告的UserControl也适合使用。
Html.RenderAction则会先去呼叫Controller的Action方法，如果此UserControl是需要透过资料库取得资料来呈现（透过Action来读取资料库），此时会比较适合使用此方式。
补充：
1、带有Render的方法返回值是void，在方法内部进行输出；不带的返回值类型为MvcHtmlString,所以只能这样使用：
@Html.Partial 对应 @{Html.RenderPartial(....);}
@Html.Action 对应 @{Html.RenderAction(....);}
2、Html.Partial可以直接提供用户控件名作为参数，而Html.Action需要有对应的Action，在Action内部返回PartailResult(即retun PartialView())。
3、对于简单的没有任何逻辑的用户控件，推荐使用Html.Partial；对于需要设置一些Model的用户控件，推荐使用Html.Action。当然，有Model数据也是可以使用Html.Partial方法的，可以看方法的重载。
4、使用Html.Action有个好处，就是可以根据不同的场景选择不同的用户控件。
比如：
@Html.Action("UserInfoControl")
在对应的UserInfoControl这个Action中,在用户未登录的时候，可以retun PartialView("LogOnUserControl");登录后，可以retun PartialView("UserInfoControl");
