Blocos de declaração de código

  • Artigo

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Blocos de declaração de código definem seções do código de servidor que são incorporadas no ASP.NET Visual Basic 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 na @ Page ou @ Control diretiva. Se nenhum idioma for especificado na diretiva, o padrão é VB, a menos que você tenha alterado o padrão no arquivo Web. config de 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 na script bloco é executado no servidor e não no 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.

Remarks

Blocos de declaração de código são definidos usando <script> tags que contêm um runat valor definido como o atributo server. O <script> elemento opcionalmente pode usar um language atributo para especificar o idioma do 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 arquivos global. asax, controles de usuário, páginas mestras e páginas da Web. 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 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 a src de atributo, todo o conteúdo entre as marcas de abertura e fechamento da <script> elemento será ignorado. Nesse caso, use uma 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 evento.

Security noteSecurity Note

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 Script Exploits Overview.

 
<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

Concepts

ASP.NET Web Page Syntax Overview