Share via


Code Declaration Blocks

Blocos de declaração de código definem seções de código de servidor que são incorporadas no ASP.NET aplicativo arquivos dentro de <script> blocos marcados com um runat="server" atributo.

<script runat="server" language="codelanguage" Src="pathname">
   Code goes here.
</script>

Atributos

  • language
    Especifica o idioma usado neste bloco de declaração de código. Esse valor pode representar qualquer.Linguagem compatível com o NET Framework, como, por exemplo, Visual Basic (VB), C# ou JScript.NET. Se nenhum idioma for especificado, o valor padrão é especificado no @ Page ou @ Control diretiva. Se nenhum idioma for especificado na diretiva, o padrão é VB, a menos que você alterou o padrão no arquivo Web. config do. seu aplicativo

    Observação

    Somente um idioma pode ser usado para um aplicativo ASP.NET página ou controle de usuário.Se você especificar o idioma em vários locais (que é desnecessário), como na tag de abertura de um bloco de declaração de código e de @ Page ou @ Control diretriz, eles devem coincidir.

  • runat
    Quando o valor é runat="server", este atributo especifica que o código contido dentro de script bloco é executado no servidor e não do cliente. Esse atributo é necessário para blocos de código do lado do servidor.

  • src
    Especifica o caminho e o nome de um arquivo de script externo para carregar. Quando esse atributo é usado, qualquer outro código no bloco de declaração é ignorado.

Comentários

Blocos de declaração de código são definidos usando <script> tags que contêm um runat valor de atributo definido como server. O <script> elemento opcionalmente pode usar um language atributo para especificar o idioma de seu código interno. Se nenhum for especificado, ASP.NET padrões para o idioma configurado para o controle de usuário ou página base (controlado usando o @ Page e @ Control diretivas). Esses blocos de código do lado do servidor podem ser declarados dentro de um número de página ASP.Arquivos de aplicativo de rede, incluindo páginas da Web, controles de usuário, páginas mestras e arquivos global. asax. Quando um determinado ASP.Arquivo de aplicativo NET é compilado, o bloco de código incorporado é compilado com o objeto específico que está associado a determinado ASP.Tipo de arquivo NET. Por exemplo, quando uma página é compilada, blocos de declaração qualquer código incorporado são compilados junto com o Page a classe em um objeto de única página no servidor.

Você também pode usar o <script> elemento para especificar um arquivo de script externo usando o src atributo. Quando você define o src de atributo todo o conteúdo entre as marcas de abertura e fechamento da <script> elemento será ignorado. Nesse caso, use a barra de fechamento no final da tag de abertura. Por exemplo: <script runat="server" src="myFile.cs" />.

Exemplo

O exemplo de código a seguir demonstra como você pode definir a lógica de manipulação de eventos para o EnterBtn_Click de evento.

Observação de segurançaObservação sobre segurança

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança.Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML.Para obter mais informações, consulte Visão geral de scripts maliciosos.

<html>
  <script language="C#" runat="server">
      void EnterBtn_Click(Object Src, EventArgs E) {
          Message.Text = "Hi " + Name.Text + ", welcome to ASP.NET!";
      }
  </script>

  <body>
   <form runat="server">
    Enter your name: <asp:textbox id="Name" runat=server/> 
                     <asp:button text="Enter" Onclick="EnterBtn_Click" runat="server"/>
        <p>
        <asp:label id="Message" runat=server/>
    </form>
  </body>
</html>
<html>
  <script language="VB" runat="server">
      Sub EnterBtn_Click(Src As Object, e As EventArgs)
         Message.Text = "Hi " & Name.Text & ", welcome to ASP.NET!"
      End Sub
  </script>

  <body>
   <form runat="server">
    Enter your name: <asp:textbox id="Name" runat=server/> 
                     <asp:button text="Enter" Onclick="EnterBtn_Click" 
                       runat="server"/>
        <p>
        <asp:label id="Message" runat=server/>
    </form>
  </body>
</html>

Consulte também

Conceitos

Visão geral da sintaxe de página da Web ASP.NET