Comment : activer le débogage pour les applications ASP.NET

Article
08/21/2008

Mise à jour : novembre 2007

Cette rubrique s'applique à :

Édition	Visual Basic	C#	C++	Web Developer
Express
Standard
Pro et Team

Légende du tableau :

	Applicable
	Non applicable
	Commande ou commandes masquées par défaut.

Pour activer le débogage, vous devez l'activer à la fois sur la page Propriétés de projet et dans le fichier web.config de l'application.

Remarque :
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour activer le débogage ASP.NET dans les propriétés de projet (Visual Basic/C#)

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom d'un projet Web et sélectionnez Pages de propriétés.

Les Pages de propriétés de <Projet> apparaissent.
Cliquez sur l'onglet Web.
Sous Débogueurs, activez la case à cocher ASP.NET.

Activer le débogage dans le fichier web.config

Ouvrez le fichier web.config à l'aide d'un éditeur de texte standard ou d'un analyseur XML.
1. Toutefois, vous ne pouvez pas accéder au fichier à distance en utilisant un navigateur Web. Pour des raisons de sécurité, ASP.NET configure Microsoft IIS pour empêcher l'accès direct aux fichiers Web.config à partir du navigateur. Si vous essayez d'accéder à un fichier de configuration à l'aide d'un navigateur, vous obtenez une erreur d'accès HTTP 403 (Refusé).
Web.config étant un fichier XML, il contient des sections imbriquées marquées par des balises. L'exemple suivant illustre un fichier Web.config typique. Modifiez le fichier en procédant comme suit :
1. Localisez la balise <compilation>. Elle marque le début de la section <compilation>.
2. À l'intérieur de la balise <compilation>, vous créerez l'attribut de débogage. Dans l'exemple suivant, debug est le deuxième attribut spécifié dans la balise <compilation>, mais l'ordre importe peu.
3. Les attributs respectent la casse ; par conséquent, veillez à spécifier "debug" et pas "Debug" ou "DEBUG".
4. Définissez la valeur de debug à true, comme illustré dans l'exemple de code suivant.
Si vous n'affectez pas à l'attribut de débogage la valeur true et si vous tentez de lancer une session de débogage, une boîte de dialogue apparaîtra pour vous proposer de créer un fichier web.config avec le jeu d'attributs. Acceptez et poursuivez le débogage.

Exemple

<configuration>
    <system.web>
        <compilation defaultLanguage="VB"
            debug="true"
            numRecompilesBeforeAppRestart="15">
            <compilers>
            <compiler language="VB;VBScript"
            extension=".cls"
            type="Microsoft.VisualBasic.VBCodeProvider,system, Version=1.0.5000.0,
Culture=neutral, PublicKeyToken=b77a5c561934e089" />
            < compiler language="C#;Csharp"
                extension=".cs" 
                type="Microsoft.CSharp.CSharpCodeProvider,system, Version=1.0.5000.0,  Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        </compilers>

        <assemblies>
""            <add assembly="ADODB" />
            <add assembly="*" />
            </assemblies>

            <namespaces>
            <add namespace="System.Web" />
            <add namespace="System.Web.UI" />
            <add namespace="System.Web.UI.WebControls" />
            <add namespace="System.Web.UI.HtmlControls" />
        </namespaces>

        </compilation>
    </system.web>
</configuration>

Programmation fiable

ASP.NET détecte automatiquement les modifications apportées aux fichiers Web.config et applique les nouveaux paramètres de configuration. Vous n'avez pas besoin de redémarrer l'ordinateur ou le serveur IIS pour que les modifications prennent effet.

Un site Web peut contenir plusieurs répertoires et sous-répertoires virtuels, et des fichiers Web.config peuvent exister dans chacun d'entre eux. Les applications ASP.NET héritent des paramètres des fichiers Web.config à des niveaux plus élevés dans le chemin d'accès de l'URL. Les fichiers de configuration hiérarchiques vous permettent de modifier les paramètres pour plusieurs applications ASP.NET en même temps, par ex. toutes les applications qui se trouvent à un niveau inférieur dans la hiérarchie. Toutefois, si debug est défini dans un fichier inférieur dans la hiérarchie, il se substitue à la valeur la plus élevée.

Par exemple, vous pouvez spécifier debug="true" dans www.microsoft.com/aaa/Web.config, et toutes les applications dans le dossier aaa ou dans les sous-dossiers d'aaa hériteront de ce paramètre. Donc si votre application ASP.NET se trouve dans www.microsoft.com/aaa/bbb,elle héritera de ce paramètre, tout comme les applications ASP.NET qui se trouvent dans www.microsoft.com/aaa/ccc, www.microsoft.com/aaa/ddd, et ainsi de suite. La seule exception est si l'une de ces applications se substitue au paramètre au moyen de son propre fichier Web.config inférieur.

L'activation du mode débogage affecte considérablement les performances de votre application ASP.NET. N'oubliez pas de désactiver le mode débogage avant de déployer une application release ou procédez à des mesures de performances.

Voir aussi

Autres ressources

Débogage d'applications ASP.NET et AJAX

Partager via