Como usar o atributo AutoEventWireup no Visual Basic .NET

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
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.

back to the top

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
back to the top

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" %>
back to the top

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 SubEnd 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 .
back to the top

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 SubEnd 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ê.
back to the top

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):back to the top

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.

back to the top
Referências
Para obter informações adicionais, clique nos números abaixo para ler os artigos na Base de dados de Conhecimento da Microsoft:
303247Visão geral sobre o modelo de code-behind do ASP.NET
312311Como 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:back to the top

Aviso: este artigo foi traduzido automaticamente

Propriedades

ID do Artigo: 317690 - Última Revisão: 04/29/2007 05:57:31 - Revisão: 1.7

Microsoft ASP.NET 1.1, Microsoft ASP.NET 1.0, Microsoft Visual Basic .NET 2003 Standard Edition, Microsoft Visual Basic .NET 2002 Standard Edition

  • kbmt kbconfig kbhowtomaster kbwebforms KB317690 KbMtpt
Comentários