ASP.NET MVC - Assistentes HTML

Os assistentes HTML são usados para modificar a saída HTML.

Assistentes HTML

Através do MVC, os assistentes HTML são semelhantes aos controles tradicionais do ASP.NET Web Form.

Semelhante aos controles web form do ASP.NET, os assistentes HTML são usados para modificar HTML. No entanto, os assistentes HTML são mais leves. Diferente dos controles web form, os assistentes HTML não têm modelo de eventos e view state.

Na maioria dos casos, os assistentes HTML são métodos que retornam strings.

Através do MVC, você pode criar seus próprios assistentes ou usar os assistentes HTML embutidos.

Assistentes HTML padrão

O MVC inclui assistentes padrão para a maioria dos tipos de elementos HTML comuns, como links HTML e elementos de formulários HTML.

Link HTML

A maneira mais simples de apresentar um link HTML é usando o assistente Html.ActionLink().

Através do MVC, Html.ActionLink() não conecta ao visual. Ele cria uma conexão com a ação do controlador (controller action).

Sintaxe Razor:

@Html.ActionLink("Sobre este Site", "About")

Sintaxe ASP:

<%=Html.ActionLink("Sobre este Site", "About")%>

O primeiro parâmetro é o texto do link, o segundo parâmetro é o nome da operação do controlador.

O assistente Html.ActionLink() acima gera o seguinte HTML:

<a href="/Home/About">Sobre este Site</a>

Vários parâmetros do assistente Html.ActionLink():

Parâmetros Descrição
linkText Texto interno do elemento de referência.
actionName Nome da operação.
controllerName Nome do controlador.
protocol Protocolo do URL, como "http" ou "https".
hostname Nome do host do URL.
fragment Nome do fragmento de URL (nome do ponto de referência).
routeValues Um objeto que contém os parâmetros de roteamento.
htmlAttributes Um objeto que contém as características HTML a serem configuradas para esse elemento.

Observação：Você pode passar valores para operações de controlador. Por exemplo, você pode passar o id de um registro de banco de dados para uma operação de edição de banco de dados.

Sintaxe Razor C#：

@Html.ActionLink("Editar Registro", "Edit", new {Id=3})

Sintaxe Razor VB：

@Html.ActionLink("Editar Registro", "Edit", New With{.Id=3})

O assistente Html.ActionLink() acima gera o seguinte HTML:

<a href="/Home/Edit/3">Editar Registro</a>

Elementos de formulário HTML

Os seguintes assistentes HTML podem ser usados para apresentar (modificar e exibir) elementos de formulário HTML：

  • BeginForm()
  • EndForm()
  • TextArea()
  • TextBox()
  • CheckBox()
  • RadioButton()
  • ListBox()
  • DropDownList()
  • Hidden()
  • Password()

Sintaxe ASP.NET C#：

<%= Html.ValidationSummary("A criação não foi bem-sucedida. Corrija os erros e 
tente novamente.") %>
<% using (Html.BeginForm()){%>
<p>
<label for="Nome">Nome:</label>
<%= Html.TextBox("FirstName") %>
<%= Html.ValidationMessage("FirstName", "*") %>
</p>
<p>
<label for="LastName">Sobrenome:</label>
<%= Html.TextBox("LastName") %>
<%= Html.ValidationMessage("LastName", "*") %>
</p>
<p>
<label for="Password">Senha:</label>
<%= Html.Password("Password") %>
<%= Html.ValidationMessage("Password", "*") %>
</p>
<p>
<label for="Password">Confirmar Senha:</label>
<%= Html.Password("ConfirmPassword") %>
<%= Html.ValidationMessage("ConfirmPassword", "*") %>
</p>
<p>
<label for="Profile">Perfil:</label>
<%= Html.TextArea("Profile", new {cols=60, rows=10})%>
</p>
<p>
<%= Html.CheckBox("ReceiveNewsletter") %>
<label for="ReceiveNewsletter" style="display:inline">Receber Newsletter?</label>
</p>
<p>
<input type="submit" value="Registrar" />
</p>
<%}%>