DOC : Informations relatives à l'attribut AutoEventWireup

Traductions disponibles Traductions disponibles
Numéro d'article: 814745 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Résumé

Cet article décrit l'attribut AutoEventWireup :
  • AutoEventWireup est un attribut booléen qui indique si des événements d'une page Web Forms sont autocâblés.
  • La valeur par défaut de AutoEventWireup est TRUE et elle peut être définie comme suit :
    • TRUE lorsque l'autocâblage d'événements est activé.
    • FALSE lorsque l'autocâblage d'événements est désactivé.

Plus d'informations

Dans Visual Studio .NET, les événements sont liés à des méthodes de gestionnaire d'événements au moyen de délégués d'événements. Si vous utilisez le Concepteur Web Forms pour concevoir des Web Forms, le concepteur génère automatiquement du code pour lier les événements à leurs méthodes de gestionnaire d'événements.

Dans Visual Basic .NET, le concepteur effectue cette liaison à l'aide du mot clé Handles dans la déclaration de la méthode de gestionnaire d'événements.

L'exemple de code suivant illustre l'utilisation du mot clé Handles dans Visual Basic .NET :
Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
Dans Visual C# .NET, le concepteur génère un délégué d'événement explicite :
this.Load += new System.EventHandler(this.Page_Load);
Le Framework des pages ASP.NET prend en charge un autre mécanisme qui utilise l'attribut AutoEventWireup d'une page Web Forms pour associer automatiquement des événements de page à des méthodes de gestionnaire d'événements. Si l'attribut AutoEventWireup de la directive @ Page est défini sur TRUE (ou s'il n'est pas spécifié car la valeur par défaut est TRUE), le Framework des pages ASP.NET appelle automatiquement des méthodes de gestionnaire d'événements de page.

Par exemple, les méthodes de gestionnaire d'événements Page_Init et Page_Load sont appelées de manière explicite par le Framework des pages ASP.NET sans utilisation du mot de passe Handles ni d'un délégué d'événement explicite.

Toutefois, l'inconvénient posé par l'utilisation de l'attribut AutoEventWireup pour associer automatiquement des événements de page à leurs méthodes de gestionnaire d'événements est que les méthodes de gestionnaire d'événements doivent avoir des noms standard prédéfinis. Cela limite l'affectation des noms des méthodes de gestionnaire d'événements.

Visual Studio .NET ne possède pas la même limitation quant aux noms des méthodes. Dans Visual Studio .NET, la valeur par défaut de AutoEventWireup est FALSE. De plus, le concepteur utilise toujours le mot clé Handles ou un délégué d'événement explicite pour lier des événements à leurs méthodes de gestionnaire d'événements. En conséquence, vous pouvez affecter des noms non standard aux méthodes de gestionnaire d'événements.

Conclusion

Lorsque vous définissez de manière explicite AutoEventWireup sur TRUE, Visual Studio .NET, par défaut, génère du code pour lier les événements à leurs méthodes de gestionnaire d'événements. En même temps, le Framework des pages ASP.NET appelle automatiquement les méthodes de gestionnaire d'événements en fonction de leurs noms prédéfinis. Cela peut donc provoquer le double appel d'une méthode de gestionnaire d'événements lors de l'exécution de la page. Par conséquent, Microsoft recommande de toujours définir AutoEventWireup sur FALSE lorsque vous travaillez dans Visual Studio .NET.

Références

Pour plus d'informations, reportez-vous aux sites Web MSDN (en anglais) aux adresses suivantes :
Modèle d'événement de contrôle serveur ASP.NET
http://msdn2.microsoft.com/en-us/library/59t350k3(vs.71).aspx
@ Page
http://msdn2.microsoft.com/en-us/library/ydy4x04a(vs.71).aspx

Propriétés

Numéro d'article: 814745 - Dernière mise à jour: mercredi 16 mai 2007 - Version: 1.6
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • MSDN 2003 Universal Edition
  • Microsoft .NET Framework 1.1
  • Microsoft .NET Framework 1.0
  • Microsoft Visual Studio .NET 2003 Éducation
  • Microsoft Visual Studio .NET 2003 Enterprise Architect
  • Microsoft Visual Studio .NET 2003 Enterprise Developer
  • Microsoft Visual Studio .NET 2003 Professional
  • Microsoft Visual Studio .NET 2002 Éducation
  • Microsoft Visual Studio .NET 2002 Enterprise Architect
  • Microsoft Visual Studio .NET 2002 Enterprise Developer
  • Microsoft Visual Studio .NET 2002 Professional Edition
Mots-clés : 
kbdesigner kbhelp kbdocs kbonline kbinetdev kbenv kbevent kbctrl kbcontrol kbwebforms kbprogramming kbdocerr KB814745
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com