ID do artigo: 317690 - Última revisão: domingo, 29 de abril de 2007 - Revisão: 1.7

Como usar o atributo AutoEventWireup no Visual Basic .NET

Vista lado a ladoClique aqui para exibir o artigo traduzido e o artigo original em inglês, lado a lado.
Tradução automáticaExibir Aviso de Isenção de Tradução Automática
Exibir os produtos aos quais esse artigo se aplica.
Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que está a utilizar. Foi desactivado o conteúdo do artigo, que pode não ser relevante para si.

Nesta página

Expandir tudo | Recolher tudo

Sumário

Este artigo descreve como usar o atributo AutoEventWireup com eficiência no Microsoft ASP.NET Web Forms.

AutoEventWireup é um atributo da diretiva @ Page . O atributo AutoEventWireup pode ter um valor de Verdadeiro ou Falso . Quando um aplicativo ASP.NET é criado usando o Microsoft Visual Studio .NET, o valor do atributo AutoEventWireup é definido como false . Este artigo descreve como definir e alterar os valores padrão do atributo AutoEventWireup . Este artigo também explica o uso desse atributo com exemplos de código de Web Forms do ASP.NET que está escrito em Microsoft Visual Basic .NET.

Você pode usar o atributo AutoEventWireup para Web Forms do ASP.NET e controles de usuário da Web de código. Quando você definir o valor do atributo AutoEventWireup como true , o resultado é código simples. Se você definir o valor do atributo AutoEventWireup para false em determinadas circunstâncias, o aplicativo ASP.NET executa melhor.

Você pode especificar o valor padrão do atributo AutoEventWireup nos seguintes locais:
  • O arquivo Machine.config
  • O arquivo Web.config
  • Individual Web Forms (arquivos .aspx)
  • Controles de usuário da Web (arquivos .ascx)
Quando você define o valor do atributo AutoEventWireup como true , o runtime do ASP.NET não requer eventos para especificar os manipuladores de eventos como Page_Load ou Page_Init . Isso significa que a palavra-chave Handles no Visual Basic .NET não ter a ser usado no script de servidor no formulário da Web.

Por padrão, quando o aplicativo ASP.NET é criado no Visual Studio. NET, o valor do atributo AutoEventWireup é definido como false na página .aspx e manipuladores de eventos são criados automaticamente. Este artigo descreve as configurações padrão do atributo AutoEventWireup e lista alguns códigos úteis.


Voltar para o início

Requisitos

Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:
  • Programação com o ASP.NET
  • Programação com o Visual Basic .NET
A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • Microsoft Visual Studio .NET 2002 ou Microsoft Visual Studio .NET 2003
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
Voltar para o início

Configure os valores padrão do atributo AutoEventWireup

O valor do atributo AutoEventWireup pode ser declarado na seção <pages> no arquivo Machine.config ou no arquivo Web.config da seguinte maneira:
<configuration>
   <system.web>
      <pages autoEventWireup="true|false" />
   </system.web>
</configuration>
se você fizer essas alterações no arquivo Machine.config, as alterações afetam todos os Web Forms do ASP.NET no computador. Se você fizer essas alterações no arquivo Web.config, as alterações afetam somente o aplicativo que o arquivo pertence.

O valor do atributo AutoEventWireup também pode ser alterado no formulário da Web individuais. Para alterá-lo no formulário da Web, adicione o atributo AutoEventWireup à diretiva @ Page, da seguinte forma: 
<% @Page AutoEventWireup="true" %>
Voltar para o início

Defina o valor do atributo AutoEventWireup para false

Se você desejar ligar eventos a uma função manualmente, use o valor false do atributo AutoEventWireup . Os exemplos a seguir mostram o código que você pode usar para manipular o evento Load do objeto Page em um formulário Web do ASP.NET:
  1. Inicie o Visual Studio NET..
  2. No menu arquivo , aponte para novo e, em seguida, clique em Project .
  3. Na caixa de diálogo New Project , clique em Projetos do Visual Basic em Tipos de projeto e, em seguida, clique em ASP.NET Web Application em modelos .
  4. Na caixa Location , digite http:// ServerName / MyWebApp e em seguida, clique em OK .

    Observação O espaço reservado ServerName é um nome de servidor e MyWebApp é um exemplo de aplicativo ASP.NET.
  5. No Solution Explorer, clique com o botão direito no arquivo WebForm1.aspx, clique em Renomear e, em seguida, digite EventWireUpFalse.aspx .
  6. Substituir o código existente no EventWireUpFalse.aspx arquivo com o código a seguir: 
    <%@ Page Language="vb" AutoEventWireup="false" Inherits="MyWebApp.EventWireUpFalse"%>
<html>
   <head>
      <title>Visual Basic .NET WIRE-UP FALSE</title>      
   </head>   
      <body><p><% Response.Write(message) %></p></body>   
</html>
  7. Substituir o código existente no EventWireUpFalse.aspx.vb arquivo com o código a seguir: 
    Public Class EventWireUpFalse
    Inherits System.Web.UI.Page

   Public message As String
   Public Sub Page_Load(ByVal Sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load    
    'MyBase.Load is the type for the Load event of the page.
      message = "The Page_Load event fired with the AutoEventWireup attribute set to false"
   End Sub

End Class
  8. No menu Debug , clique em Iniciar para criar e executar o projeto.

    Neste exemplo, você recebe uma mensagem quando a estrutura página ASP.NET é acionado a rotina Page_Load . Como o valor do atributo AutoEventWireup é definido como false , você usar a palavra-chave Handles e siga-lo com uma referência para o evento Load : MyBase.Load .
Voltar para o início

Defina o valor do atributo AutoEventWireup para true

Quando você define o valor do atributo AutoEventWireup para false , você deve manualmente ligar eventos a funções. Por outro lado, quando você define o valor do atributo AutoEventWireup como true , a estrutura página ASP.NET pode automaticamente ligar eventos. Para codificar o manipulador de eventos Page_Load em um formulário Web do ASP.NET quando o valor do atributo AutoEventWireup é true , execute estas etapas:
  1. O Visual Studio .NET.
  2. No menu arquivo , aponte para novo e, em seguida, clique em Project .
  3. Na caixa de diálogo New Project , clique em Projetos do Visual Basic em Tipos de projeto e, em seguida, clique em ASP.NET Web Application em modelos .
  4. Na caixa Location , digite http:// ServerName / MyWebApp e em seguida, clique em OK . Observação: O espaço reservado ServerName é um nome de servidor e MyWebApp é um exemplo de aplicativo ASP.NET.
  5. No Solution Explorer, clique com o botão direito no arquivo WebForm1.aspx, clique em Renomear e, em seguida, digite EventWireUpTrue.aspx .
  6. Substitua o código existente no arquivo EventWireUpTrue.aspx com o código a seguir: 
    <%@ Page Language="vb" AutoEventWireup="true" Inherits="MyWebApp.EventWireUpTrue"%>
<html>
   <head>
      <title>Visual Basic .NET WIRE-UP TRUE</title>      
   </head>   
      <body><p><% Response.Write(message) %></p></body>   
</html>
  7. Substituir o código existente no EventWireUpTrue.aspx.vb arquivo com o código a seguir: mensagem 
    Public Class EventWireUpTrue
   Inherits System.Web.UI.Page

   Public message As String
   Public Sub Page_Load(ByVal Sender As System.Object, ByVal e As System.EventArgs)
      message = "The Page_Load event fired with the value of the AutoEventWireup attribute set to true."
   End Sub

End Class
  8. No menu Debug , clique em Iniciar para criar e executar o projeto.

    Use o manipulador de eventos Page_Load para exibir uma mensagem. No entanto, nesse caso você não precisará usar a palavra-chave Handles porque a estrutura página ASP.NET faz isso para você.
Voltar para o início

Evite definir o atributo AutoEventWireup para true quando o desempenho é chave

Você não deve definir o valor do atributo AutoEventWireup como true se desempenho for uma consideração de chave. Se você definir o valor do atributo AutoEventWireup como true , a estrutura página ASP.NET deve fazer uma chamada para o método CreateDelegate para cada formulário da Web (página .aspx). Em vez de depender de conexão automática, substitua manualmente os eventos da página, conforme mostrado nos exemplos de código neste artigo.

Para obter mais informações, visite o seguinte site da Web Microsoft Developer Network (MSDN):
http://msdn.microsoft.com/library/en-us/dndotnet/html/dotnetperftips.asp (http://msdn.microsoft.com/library/en-us/dndotnet/html/dotnetperftips.asp)
Voltar para o início

Use o atributo AutoEventWireup de outras maneiras

O atributo AutoEventWireup também é um atributo da diretiva @ Control que é usada em controles de usuário da Web. Você pode usar o atributo AutoEventWireup de maneiras que são semelhantes neste artigo.

Voltar para o início

Referências

Para obter informações adicionais, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
303247  (http://support.microsoft.com/kb/303247/ ) Visão geral sobre o modelo de code-behind do ASP.NET
312311  (http://support.microsoft.com/kb/312311/ ) Como trabalhar com arquivos de classe code-behind em um aplicativo ASP.NET usando Visual Basic .NET
Para obter mais informações, visite os seguintes sites da MSDN:
http://msdn2.microsoft.com/en-us/library/ydy4x04a(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/ydy4x04a(vs.71).aspx)

http://msdn.microsoft.com/en-us/library/fy30at8h.aspx (http://msdn.microsoft.com/en-us/library/fy30at8h.aspx)

http://msdn.microsoft.com/en-us/library/at2tetf6(VS.71).aspx (http://msdn.microsoft.com/en-us/library/at2tetf6(VS.71).aspx)

http://msdn2.microsoft.com/en-us/library/edzehd2t(vs.71).aspx (http://msdn2.microsoft.com/en-us/library/edzehd2t(vs.71).aspx)

http://msdn.microsoft.com/en-us/library/ms973839.aspx (http://msdn.microsoft.com/en-us/library/ms973839.aspx)
Voltar para o início
A informação contida neste artigo aplica-se a:
  • Microsoft ASP.NET 1.1
  • Microsoft ASP.NET 1.0
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
Voltar para o início
Palavras-chave: 
kbmt kbconfig kbhowtomaster kbwebforms KB317690 KbMtpt
Voltar para o início
Tradução automáticaTradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 317690  (http://support.microsoft.com/kb/317690/en-us/ )
Voltar para o início