• 《ASP.NET MVC4 WEB编程》学习笔记------HtmlHelper


    本文转载自powerzhang如果给您带来不便请联系博主。

    在实际的程序中,除了在View中展示数据外,还需要在View与后台的数据进行交互,在View中我就需要用的表单相关的元素;

      在MVC3框架中,我们可以用到Html的相关辅助方法进行对表单的输出;

      视图中Html的类型是System.Web.Mvc.HtmlHelper<T>

    1、  Html.BeginForm()

      主要是生成表单的form值,如果表单时强类型视图,则在提交表单的时候,会自动将表单元素name名称与强类型视图中的类型实体的属性值相同的进行填充;

      同样在表单中,如果我们是强类型视图,则可以直接使用@Model.UserName将值输到指定位置;

    2、  Html.ValidationSummary()

      一般我们在controller中选定的action下添加强类型的create视图,都会在表单下生成Html.ValidationSummary(true);这样的东西,传true和false有什么区别了?

      ValidationSummary辅助方法可以用来显示ModelState字典中所有验证错误的无序列表。使用bool类型参数(值为true的情况)来告知辅助方法排除属性级别错误;

      具体示例解释如下

    public ActionResult SelStudent() {
                ModelState.AddModelError("", "this is all wrong");
                ModelState.AddModelError("UserName", "is Required");
                Student s = new Student();
                s.UserName = "regicide";
                return View(s);
            }
    View Code

      如果在页面使用Html.ValidationSummary(true); 则is required会显示在对应的UserName文本框的下面;如果使用false则isRequired会显示到this is all wrong下面

      

      注:如果要显示出对应的样式,引入/Content/Site.css即可

    3、  Html.TextBox()、Html.TextArea()

      此方法主要为生成<input type=’text’ />和<textarea>< textarea />

    @Html.TextBox("title","",new {@style="background-color:red",ReadOnly="ReadOnly"})

      就会生成如下的html标签;如果你使用@Html.Editor方法则不会提供传递html元素的相关重载;

    <input ReadOnly="ReadOnly" id="title" name="title" style="background-color:red" type="text" value="" />

      注:如果在强类型视图中按照如下定义

    public ActionResult SelStudent() {
                Student s = new Student();
                ViewBag.UserName = "free";
                s.UserName = "regicide";
                return View(s);
            }

      然后通过@Html.TextBox("UserName")输出,则<input type=’text’ />元素中默认值是free而不是regicide,因为在页面的取值中,如果不强行指定取Model的UserName则会默认取ViewBag的动态值UserName

      如果我们给一个文本框加自己的属性比如new{data_my1=’free’}此时被编译后是data-my1=’free’,注意下划线和短横线的区别;

    4、  Html.Label()

      在我们的使用中,很少使用label的标签,label标签视乎并不常用;其实lable的妙用在于

    <label for="Age">Age</label>
    <input class="text-box single-line" data-val="true" data-val-number="字段 Age 必须是一个数字。" id="Age" name="Age" type="text" value="" />

      当我们点击label标签(age)的时候,光标会自动定位到id位age的文本框;所以Html.label()主要生成<label for="Age">Age</label>的label

    5、  Html.DropDownList()

      下拉框的用法,主要是用于在后台查询出的IEnumerable进行数据绑定;

      示例为:  

    public ActionResult SelStudent() {
                List<SexSelect> sss = new List<SexSelect>();
                SexSelect ss = new SexSelect();
                ss.Id = 0;
                ss.Text = "";
                sss.Add(ss);
                ss = new SexSelect();
                ss.Id = 1;
                ss.Text = "";
                sss.Add(ss);
                var t = sss.AsEnumerable();
                ViewBag.Sex = new SelectList(t, "Id", "Text");
                return View(s);
            }
    View Code

    @Html.DropDownList("Sex")就会自动绑定后台指定的t显示到下来框;

    6、  Html.ValidationMessage()

      当ModelState字典中出现错误时,可以使用此方法来显示相应的错误;此用法在第二点中(Html.ValidationSummary())略有提到,后面讲模型验证还会继续的说明此用法

    7、  Html.Editor()

      此方法在生成html元素最为特殊,因为上面的根据名称可以知道大致的html元素控件;而editor则不一样了;

      Editor方法可以通过数据注解来改变生成Html,比如我在实体上面指定“DataType[DataType.MultitineText]”,则Editor则会自动生成为<textarea></textarea>标签;

      并且Eidtor方法还支持模板的重载;

      在Controller对应的文件下面添加子文件夹,命名为“EditorTemplates”(强命名),然后添加一个名为“DateTime.cshtml”(强命名),并写如下代码:

    @{
        Layout = null;
    }
    @Html.TextBox("",ViewData.TemplateInfo.FormattedModelValue,new {@class="text-box single-line",data_datepicker="true",data_test="regicide"})

      则在强类型实体中定义为DateTime类型的字段通过Editor生成就会变成如下:

    <input class="text-box single-line" data-datepicker="true" data-test="regicide" id="Birthday" name="Birthday" type="text" value="" />

      这就是Editor的根据模型进行智能生成的好处;当然如果有的部分不想使用DateTime.cshtm中的方式进行生成html,可以将DateTime.cshtml进行更名,更名后,使用@Html.Editor("Birthday","SpecialDateTime")“SpecialDateTime”为视图名称,这样也可以进行生成.

    8、  Html.Hidden()

    Hidden就是生成隐藏文本域的方法;比如:

    @Html.Hidden("id","1")

    就会生成一个隐藏文本域

    <input id="guid" name="guid" type="hidden" value="1" />

    MVC3中如果使用强类型隐藏文本域的作用就很大,比如一个更新的强类型视图,一共有5个字段,你只更新3个字段,那么就需要把另外两个字段放在隐藏文本域中,否则的话,强类型提交到后台就就只会赋值页面绑定的3个字段,另外2个会丢失

    9、  Html.Password()

    这个比较简单,用法跟hidden一样,就是会生成一个password类型的input

    <input id="pass" name="pass" type="password" value="123456" />

    10、Html.RadioButton()

    RadioButton主要是生成一组来供用户选择,根据name来确定一组按钮;

    @Html.RadioButton("color", "red")<text>red</text>
    @Html.RadioButton("color", "blue",true)<text>blue</text>
    @Html.RadioButton("color", "green")<text>green</text>

    就会生成为:

    <input id="color" name="color" type="radio" value="red" /><text>red</text>
    <input checked="checked" id="color" name="color" type="radio" value="blue" /><text>blue</text>
    <input id="color" name="color" type="radio" value="green" /><text>green</text>

    11、Html.CheckBox()

    这个辅助方法比较特殊一点点,CheckBox生成元素会生成2个input元素;

    @Html.CheckBox("sel",true)

    生成的源代码为:

    <input checked="checked" id="sel" name="sel" type="checkbox" value="true" />
    <input name="sel" type="hidden" value="false" />

    一个checked一个hidden;

    它渲染两个输入元素的主要原因是,HTML规范中规定了浏览器只提交选中的复选框的值,在上面的例子中即使sel的checked没有被选中,也会被提交一个false到后台;

    12、  Html.ActionLink()、Html.RouteLink()

    看到这两个,好像没怎么想到跟html中的什么东西对应;从字面上理解就是生成link的东西;

    ActionLink主要是渲染一个指向另外一个控制器操作的超链接。

    比如:

    @Html.ActionLink("超链接","SelStudent","Home")

    就会生成为:

    <a href="/Home/SelStudent">超链接</a>

    在ActionLink中还重载了一些可以传递htmlAttributs的方法;

    RouteLink和ActionLink差不多,但是RouteLink可以接收路由名称而不接收控制器名称和操作名称。

    比如上面的ActionLink的例子可以转换为

    @Html.RouteLink("超链接",new {action="SelStudent"})

    当然,还有一个区别就是可以直接指定路由名称;

    要实现上面的actionlink效果还可以写成

    @Html.RouteLink("超链接","Default")

    Default是Global启动的时候注册的一个默认路由;这里如果只指定路由,默认的action会变成当前view的action;

    13、Html.Partial()、Html.RenderPartial()--------唯一一种使用部分视图的方法

    Partial用于将分部视图转换为字符串;

    新建一个action 为PartialTest 然后添加到分部视图,就会添加一个完全空白的页面(不包含一个标签),然后在需要使用的地方

    @Html.Partial("PartialTest")

    只需要指定分部视图名称即可;

    这样就会把PartialTest中的内容写入到@Html.Partial("PartialTest")所在的位置;有点类似于java中的include导入页面一样

    RenderPartial()跟Partial差不多的用途,只是返回的值不一样;Partial返回的是MvcHtmlString,而RenderPartial返回的是空,输入我们手动的在打印一遍;

    @{Html.RenderPartial("PartialTest");}

    这样就跟Partial效果一样了;但RenderPartial不是返回字符串,而是直接写入响应输出流,直接写入响应流性能上比Partial要好一点;

    14、Html.Action()、Html.RenderAction()

    Action和RenderAction差不多,一个是直接返回MvcHtmlString一个是返回空,把数据写到响应流;   

    借上面一个示例说明下分部视图如何不让直接访问,必须用html的辅助方法访问;

    [ChildActionOnly]
            public ActionResult PartialTest() {
                return PartialView();
            }

    这样就只允许通过Html的辅助方法【Action、RenderAction、Partial、RenderPartial】来进行访问了

    在14的示例中如果在ActionResult加上一个[ActionName(“MyTest”)],此时在访问PartialTest时就要用MyTest才能访问到了;

    小结:看了这么多系统提供的Html辅助方法,我们是不是该自己写一个自定义的Html辅助方法了?那么开始吧!

    新建一个静态类,里面定义一个自己写好的方法

    public static MvcHtmlString TestHtml(this HtmlHelper html) {
                MvcHtmlString mhs = new MvcHtmlString("<div style='100;height:100;background-color:red'></div>");
                return mhs;
            }

    方法返回一个MvcHtmlString(如果是想返回html不被转义的情况下,否则可以返回string),里面顶一个div,然后直接返回;

    在页面中使用时得先引入新建的这个类的命名空间;

    在顶部写上“@using MVC3Pro.Controllers”

    然后就可以像使用其他html辅助方法一样使用点操作了;(在点操作的时候,方法的下面有个向下的小箭头,是代表扩展方法,加this传递进去,将当前方法附加到this的上面为附加方法)

    @Html.TestHtml()
    
    --------------------------------------------
    /*结果*/
    <div style='100;height:100;background-color:red'></div>
  • 相关阅读:
    poj3126--Prime Path(广搜)
    iOS中 imageNamed方法 非常多图片占用大量内存问题
    容器+AOP实现动态部署(四)
    SpringBoot整合redis哨兵主从服务
    LINUX安装REDIS集群
    软件安装
    如何优雅地用Redis实现分布式锁
    Redis面试总结
    OAuth2.0 知多少(好)
    一张图搞定OAuth2.0
  • 原文地址:https://www.cnblogs.com/abc8023/p/3497953.html
Copyright © 2020-2023  润新知