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>
        }

 

代码如下:

  1. <!DOCTYPE html>  
  2. <html>  
  3. <head>  
  4.     <title>@ViewBag.Title</title>  
  5.     <link href="@Url.Content("~/Content/Site.css")" rel="stylesheet" type="text/css" />  
  6.     <script src="@Url.Content("~/Scripts/jquery-1.4.4.min.js")" type="text/javascript"></script>  
  7.     @RenderSection("head", required: true)@*View页面自定义特定js/css使用*@  
  8. </head>  
  9.   
  10. <body>  
  11.     @RenderPage("~/Views/Shared/_Header.cshtml")  
  12.     @RenderBody()  
  13. </body>  
  14. </html>  


 

 

二、创建视图,使用母版页

代码如下:

  1. @{  
  2.     ViewBag.Title = "Index";  
  3.     Layout = "~/Views/Shared/_Layout.cshtml";  
  4. }  
  5. <h2>Index</h2>  
  6. @section Head{  
  7.     <script type="text/javascript">  
  8.         $(function () {  
  9.             alert("hello jquery");  
  10.         });  
  11.     </script>  
  12. }  
  13. <p>执行C#普通语法</p><br />  
  14. @DateTime.Now.Date.ToShortDateString()  
  15.   
  16. <p>执行C#语句段</p>  
  17. @{  
  18.     List<stringlist = new List<string> { "Mvc3", "Razor" };  
  19.     list.Add(".Net4");      
  20. }  
  21. <ul>  
  22. @foreach(string s in list)  
  23. {  
  24.     if (string.IsNullOrEmpty(s))  
  25.     {  
  26.        <li>空</li>  
  27.     }  
  28.     else  
  29.     {   
  30.        <li>@s</li>  
  31.     }  
  32. }  
  33. </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");

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。