ASP.NET expressões embutidas no .NET Framework

2024-12-14

Este artigo contém uma introdução às seguintes ASP.NET expressões embutidas:

<% ... %>
<%= ... %>
<%@ ... %>
<%# ... %>
<%$ ... %>
<%-- ... --%>

Versão original do produto: .NET Framework
Número original do KB: 976112

<% ... %> blocos de código incorporados

O bloco de código incorporado é usado para preservar a compatibilidade com versões anteriores do ASP. O código no bloco pode executar instruções de programação e chamar funções na classe de página atual durante a fase de renderização da página.

O exemplo a seguir demonstra uma página ASP.NET que tem um exemplo de código do Microsoft Visual Basic .NET em um bloco de código incorporado para exibir os resultados de um loop:

<%@ Page Language="VB" %>
<html>
<body>
    <form id="form1" runat="server">
        <% For i As Integer = 16 To 24 Step 2%>
            <div style="font-size: <% Response.Write(i)%>">
                Hello World<br />
            </div>
        <% Next%>
    </form>
</body>
</html>

Como um bloco de código incorporado é sempre misturado com a fonte HTML (HyperText Markup Language), é difícil para os desenvolvedores lê-los e mantê-los.

Para obter mais informações sobre blocos de código incorporados em páginas da Web ASP.NET, visite Blocos de código incorporados em ASP.NET páginas de formulários da Web.

<%= ... %> exibindo expressão

A <%= ... %> expressão de exibição é um equivalente do bloco de código incorporado que contém apenas a Response.Write(...) instrução. É a maneira mais simples de exibir informações como uma única string, uma variável int ou uma constante.

Por exemplo, o código de exemplo a seguir exibe a hora atual:

<%@ Page Language="VB" %>
<html>
    <body>
        <form id="form1" runat="server">
            <%=DateTime.Now.ToString() %>
        </form>
    </body>
</html>

Lembre-se de que a expressão de exibição não pode ser usada nos atributos dos controles do servidor. Isso ocorre porque o .NET Framework compila diretamente toda a expressão em vez do conteúdo de exibição como o valor do atributo.

Para obter mais informações sobre como exibir informações do ASP.NET, visite Exibição de ASP.NET.

<%@ ... %> expressão da diretiva

A expressão de diretiva é a sintaxe que especifica as configurações usadas pela página e pelos compiladores de controle de usuário quando eles processam páginas ASP.NET Web Form (.aspx) e arquivos de Controle de Usuário (.ascx).

A estrutura de página ASP.NET suporta as seguintes diretivas:

Diretiva	Descrição
`@ Page`	Define atributos específicos da página que são usados pelo analisador e compilador de página ASP.NET. Pode ser incluído apenas em arquivos .aspx. Esse nome de diretiva pode ser usado somente em páginas ASP.NET Web Form.
`@ Control`	Define atributos específicos do controle que são usados pelo analisador e compilador de página ASP.NET. Pode ser incluído apenas em arquivos .ascx (controles de usuário). O nome da diretiva só pode ser usado em arquivos de Controle de Usuário.
`@ Import`	Importa explicitamente um namespace para uma página ou para um controle de usuário.
`@ Implements`	Indica declarativamente que uma página ou um controle de usuário implementa uma interface .NET Framework especificada.
`@ Register`	Associa aliases a namespaces e a nomes de classe. O que permite que controles de usuário e controles de servidor personalizados sejam renderizados quando são incluídos em uma página solicitada ou controle de usuário.
`@ Assembly`	Vincula um assembly à página atual durante a compilação. Ele disponibiliza todas as classes e interfaces do assembly para uso na página.
`@ Master`	Identifica uma página mestra ASP.NET.
`@ WebHandler`	Identifica uma página IHttpHandler ASP.NET.
`@ PreviousPageType`	Fornece uma maneira de obter digitação forte na página anterior, conforme acessada por meio da propriedade PreviousPage.
`@ MasterType`	Atribui um nome de classe à propriedade Master de uma página ASP.NET. Fornece uma maneira de criar uma referência fortemente tipada para a página mestra ASP.NET.
`@ OutputCache`	Controla declarativamente as políticas de cache de saída de uma página ou de um controle de usuário.
`@ Reference`	Vincula declarativamente uma página ou controle de usuário à página atual ou controle de usuário.

Para obter mais informações sobre a sintaxe da diretiva, visite Sintaxe da diretiva do modelo de texto.

<%# ... %> expressão de ligação de dados

A expressão de associação de dados cria a associação entre uma propriedade de controle de servidor e uma fonte de dados quando o método DataBind do controle desse controle de servidor é chamado na página.

O exemplo a seguir mostra como usar a expressão de vinculação de dados para associar a cadeia de caracteres de uma função à propriedade Text de um rótulo:

<%@ Page Language="VB" %>
<script runat="server">
    Protected Function SayHello() As String
        Return "Hello World"
    End Function

    Protected Sub Page_PreRender(ByVal sender As Object, ByVal e As System.EventArgs)
        lblHello.DataBind()
    End Sub
</script>
<html>
    <body>
        <form id="form1" runat="server">
            <asp:Label ID="lblHello" runat="server" Text="<%# SayHello%>"></asp:Label>
        </form>
    </body>
</html>

Para obter mais informações sobre a sintaxe da expressão de associação de dados, visite Sintaxe da expressão de associação de dados.

<%$ ... %> construtor de expressões

O construtor de expressões é usado para definir valores de propriedades de controle com base nas informações contidas nos arquivos de configuração ou de recurso de um aplicativo. O exemplo a seguir é a sintaxe básica do construtor de expressões:
<%$ Expression Prefix: Expression Value %>

O cifrão ($) indica a ASP.NET que a expressão a seguir é um construtor de expressões. O prefixo da expressão define o tipo de expressão, como AppSettings, ConnectionStrings, ou Resources. Além disso, você pode criar e definir seu próprio construtor de expressões. O valor da expressão que segue os dois-pontos (:) é o que ASP.NET realmente usará como o valor de uma determinada propriedade.

A demonstração a seguir mostra como usar o construtor de expressões para obter os direitos autorais de um site do AppSettings nó no arquivo Web.config e como definir as informações de direitos autorais como o valor da propriedade Text.

O AppSettings nó no arquivo Web.config :

<appSettings>
    <add key="copyright" value="(c) Copyright 2009 WebSiteName.com"/>
</appSettings>

O construtor de expressões na página ASP.NET Formulário da Web:

<div id="footer">
    <asp:Literal ID="Literal1" runat="server" Text="<%$ AppSettings: copyright %>"></asp:Literal>
</div>

Para obter mais informações sobre ASP.NET expressões, visite ASP.NET Visão geral de expressões.

<%-- ... -- %> bloco de comentários do lado do servidor

O bloco de comentários do lado do servidor permite que os desenvolvedores incorporem comentários de código em qualquer local da fonte HTML de ASP.NET páginas de formulário da Web (exceto dentro <script> de blocos de código). Qualquer conteúdo entre as tags de abertura e fechamento do bloco de comentários do lado do servidor não será processado no servidor ou renderizado na página resultante.

O exemplo de código a seguir mostra como usar o bloco de comentários do lado do servidor em uma página ASP.NET:

<%@ Page Language="VB" %>
<script runat="server">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim strName As String
        strName = Session("userName")
        lblUserName.Text = strName
    End Sub
</script>
<html>
    <body>
        <form id="form1" runat="server">
            <%-- Label for UserName --%>
            <asp:Label ID="lblUserName" runat="server" Text=""></asp:Label>
        </form>
    </body>
</html>

Para obter mais informações sobre comentários do lado do servidor, visite Comentários do lado do servidor.

Compartilhar via