Outil Administration de site Web, onglet Application

Article
10/22/2014

Mise à jour : novembre 2007

Utilisez l'onglet Application de l'outil Administration de site Web pour gérer des paramètres fréquemment utilisés relatifs à l'application Web et au site.

Utilisez l'onglet Application pour gérer les éléments suivants :

Paires nom/valeur des paramètres de l'application.

Les paramètres de l'application sont des paires nom/valeur qui représentent le texte de valeurs configurables dans l'application Web. Utilisez les paramètres de l'application pour stocker les informations de configuration d'application personnalisées, telles que les chemins d'accès, les URL de service Web XML, le texte fréquemment utilisé ou d'autres informations que vous souhaitez conserver dans un emplacement central et modifier facilement.

Remarque importante :
Les paramètres de l'application sont stockés dans le fichier de configuration sous forme de texte brut. Par conséquent, vous devez prendre les mesures de sécurité appropriées lorsque vous les utilisez. Ne stockez pas d'informations sensibles, telles que les noms d'utilisateurs, les mots de passe ou les chaînes de connexion à une base de données dans les paramètres de l'application.

Paramètres SMTP (Simple Mail Transfer Protocol).

Si le site Web requiert la fonction d'envoi de messages électroniques (par exemple, pour envoyer un mot de passe aux utilisateurs), vous devez spécifier le serveur SMTP utilisé par votre site.
État de l'application.

Vous pouvez déconnecter votre application (l'arrêter) pour effectuer les tâches de maintenance ou mettre une nouvelle base de données Microsoft SQL Server Express Edition en ligne.
Débogage et traçage.

Le débogage et le traçage vous permettent de diagnostiquer et de résoudre des problèmes avec l'application Web et sont principalement destinés à être utilisés pendant le développement. L'activation du débogage entraîne la compilation des pages du site Web avec les informations que le débogueur .NET Framework ou Microsoft Visual Studio peut utiliser pour parcourir votre code. L'activation du traçage permet aux pages de générer des informations sur des demandes Web individuelles, des en-têtes HTTP qui sont envoyés avec les demandes, l'état des contrôles sur la page et d'autres détails relatifs au traitement de la page.

Configuration des paramètres de l'application

Lorsque vous créez un paramètre d'application, vous spécifiez un nom et une valeur pour le paramètre à créer. Cela vous permet d'accéder à la valeur du paramètre dans votre application en utilisant la propriété AppSettings de la classe ConfigurationSettings. Par exemple, si vous définissez un paramètre d'application nommé AppName avec une valeur qui représente le nom de votre application, vous pouvez l'utiliser pour définir le titre d'une page comme affiché dans l'exemple de code suivant.

[Visual Basic]

labelPageHeading.Text = ConfigurationManager.AppSettings("AppName")

[C#]

labelPageHeading.Text = ConfigurationManager.AppSettings["AppName"];

Connexion et déconnexion des applications

Si vous souhaitez effectuer des tâches de maintenance sur le site Web, vous pouvez le déconnecter. Cette opération arrête le processus exécuté sur le site Web afin que le site ne serve plus de pages. Vous pouvez ensuite modifier des pages ou d'autres fichiers sans que les autres utilisateurs puissent demander la page que vous modifiez auquel cas ils recevront probablement un message d'erreur. La déconnexion d'une application est également utile si vous utilisez SQL Server Standard Edition et souhaitez échanger ou ajouter un fichier de base de données .mdf à l'application. Si l'application est en cours d'exécution, vous ne pouvez pas attacher de nouveaux fichiers .mdf.

Une fois l'édition des fichiers, la modification ou l'ajout des fichiers .mdf terminé, vous pouvez remettre l'application en ligne.

Configuration des paramètres SMTP

Certaines fonctionnalités du site Web requièrent que votre application prenne en charge la fonction d'envoi de messages électroniques. Pour envoyer un message électronique, l'application doit avoir accès à un serveur SMTP (Simple Mail Transfer Protocol) qui transfère les messages électroniques de votre application au destinataire du message.

IIS) inclut un serveur virtuel SMTP, bien qu'il ne soit pas installé par défaut. Si vous souhaitez envoyer des messages électroniques depuis votre ordinateur, vous pouvez installer le serveur SMTP en utilisant l'option Ajout/Suppression de programmes du Panneau de configuration Microsoft Windows. Le serveur SMTP est disponible sous forme de composant Windows dans le cadre d'IIS. Une fois le serveur SMTP IIS installé, vous pouvez le configurer à l'aide de la console de gestion IIS. Pour plus d'informations sur l'installation du serveur virtuel SMTP IIS, consultez la page de recherche de la base de connaissances

Remarque :
Si vous installez un serveur SMTP sur l'ordinateur, vous devez prendre des mesures de sécurité afin de protéger le serveur SMTP contre son utilisation en tant que serveur de courriers indésirables. Pour plus d'informations sur la sécurisation du serveur virtuel SMTP IIS, accédez à Microsoft.com et effectuez une recherche sur Sécurité SMTP.

Si vous ne souhaitez pas installer le serveur SMTP IIS ou si l'application s'exécutera sur un autre ordinateur, contactez l'administrateur réseau ou de serveur Web pour plus d'informations sur les paramètres de configuration relatifs à un serveur SMTP.

Le tableau suivant décrit les paramètres SMTP.

Paramètre	Description
Server Name	Le nom de votre serveur SMTP. La valeur par défaut est localhost, ce qui signifie qu'ASP.NET utilisera un serveur SMTP sur l'ordinateur local. Il s'agit généralement du serveur virtuel SMTP par défaut et sinon, du nom d'un serveur SMTP disponible sur le réseau.
Server Port	Le port de votre serveur SMTP. La valeur par défaut est 25.
From	L'adresse de messagerie qui apparaîtra dans l'en-tête De : des messages électroniques envoyés par le site Web.
Authentification	Le type d'authentification utilisé par votre serveur SMTP, si approprié. Si votre serveur SMTP utilise une authentification de base, fournissez le nom du compte et le mot de passe d'un compte d'utilisateur qui est autorisé à transférer les messages par l'intermédiaire du serveur. Le nom d'utilisateur et le mot de passe utilisés pour l'authentification de base sont stockés sous forme de texte clair dans le fichier Web.config.

Configuration du débogage et du traçage

Vous devez disposer d'informations d'identification administratives sur l'ordinateur qui exécute l'application Web pour modifier ses paramètres de débogage et de traçage.

Pour gérer les fonctions de débogage et de traçage, cliquez sur Configurer le débogage et le traçage, puis définissez les options suivantes :

Activer le débogage

Sélectionnez cette option pour activer le débogage pour toutes les pages du site Web.
Capturer les informations de traçage

Sélectionnez cette option pour activer le traçage pour toutes les pages du site Web. Si cette case à cocher est activée, les autres options de la page sont activées.

Si vous avez activé l'option de capture des informations de traçage, vous pouvez choisir parmi les options suivantes :

Afficher les informations de traçage sur des pages individuelles

Sélectionnez cette option pour ajouter des informations de traçage dans la partie inférieure des pages Web de votre site. Les informations sont capturées même si vous n'affichez pas d'informations de traçage sur les pages individuelles. Pour consulter les informations de traçage, vous pouvez demander la page Trace.axd du site Web qui fonctionne comme une visionneuse d'informations de traçage.
Demandes locales uniquement

Sélectionnez cette option pour consulter uniquement les informations de traçage relatives à la demande du serveur Web hôte (localhost).
Toutes les demandes

Sélectionnez cette option pour consulter les informations de traçage à partir d'un ordinateur quelconque.

Sous Sélectionnez l'ordre de tri des résultats de traçage, spécifiez le mode d'affichage des informations de traçage comme suit :

Par heure

Sélectionnez cette option pour afficher les informations de traçage par ordre de capture.
Par catégorie

Sélectionnez cette option pour afficher les informations de traçage par ordre alphabétique dans les catégories définies par l'utilisateur.
Nombre de demandes de traçage à mettre en cache

Entrez le nombre de demandes de traçage à stocker sur le serveur. Vous pouvez consulter les informations mises en cache à l'aide de la visionneuse de traçage (http://serveur/application/trace.axd). La valeur par défaut est 10. Si vous ne sélectionnez pas l'option Résultats de traçage les plus récents et que la limite est atteinte, le traçage est automatiquement désactivé.

Sous Sélectionnez les résultats de traçage à mettre en cache, spécifiez le mode d'affichage de la sortie de trace comme suit :

Résultats de traçage les plus récents

Sélectionnez cette option pour afficher la sortie de trace la plus récente et ignorer les données de trace plus anciennes au-delà des limites indiquées par Nombre de demandes de traçage à mettre en cache.
Résultats de traçage les plus anciens

Sélectionnez cette option pour afficher les données de trace des demandes jusqu'à ce que la valeur définie dans Nombre de demandes de traçage à mettre en cache soit atteinte.

Remarque :
Lorsque vous avez terminé le dépannage du site Web, désactivez le débogage et le traçage pour optimiser les performances de votre application Web.

Note de sécurité :
Lorsque le traçage est activé pour une page, les informations de traçage peuvent s'afficher sur n'importe quel navigateur faisant une demande pour la page du serveur. Étant donné que le traçage affiche des informations sensibles telles que les valeurs des variables serveur, il peut constituer une menace pour la sécurité. Assurez-vous de désactiver le traçage de la page avant de publier l'application Web sur un serveur de production.

Lorsque le traçage est activé pour une page, les informations de traçage peuvent s'afficher sur n'importe quel navigateur faisant une demande pour la page du serveur. Étant donné que le traçage affiche des informations sensibles telles que les valeurs des variables serveur, il peut constituer une menace pour la sécurité. Assurez-vous de désactiver le traçage de la page avant de publier l'application Web sur un serveur de production.

Pour configurer une page d'erreurs personnalisée pour le site Web, cliquez sur Définir la page d'erreurs par défaut, puis spécifiez les options suivantes :

Utiliser le message d'erreur par défaut

Sélectionnez cette option pour utiliser la page d'erreurs par défaut.
Spécifiez l'URL à utiliser comme page d'erreurs par défaut

Sélectionnez cette option pour utiliser une page d'erreurs personnalisée, puis choisissez la page à utiliser.

En coulisse

L'onglet Application fournit une interface Web simple pour gérer les paramètres de configuration qui sont stockés dans le fichier Web.config de votre application.

Paramètres de l'application

Les paramètres gérés à l'aide de la fonctionnalité Paramètres de l'application de l'onglet Application sont disponibles dans la section <appSettings> du fichier Web.config de l'application Web. Il s'agit d'une section de configuration prédéfinie fournie par le .NET Framework. Les lignes mises en surbrillance dans le code suivant sont un exemple de fichier de configuration qui est généré suite à l'utilisation de l'outil Administration de site Web pour créer un paramètre d'application nommé ApplicationName.

<configuration>
    <appSettings>        <add key="ApplicationName" value="MyApplication" />    </appSettings>
</configuration>

Connexion et déconnexion des applications

Le paramètre de déconnexion est disponible dans la section <httpRuntime> du fichier Web.config du site Web. Les lignes mises en surbrillance dans le code suivant sont générées suite à l'utilisation de l'outil Administration de site Web pour déconnecter une application.

<configuration>
    <system.Web>
        <httpRuntime enable="False" />
    </system.Web>
</configuration>

Tant que le paramètre httpRuntime est désactivé, ASP.NET ne crée pas d'objet AppDomain pour votre application lors de la réception d'une demande. En effet, l'application Web ne peut pas être démarrée.

Paramètres SMTP

Les paramètres gérés à l'aide de la fonctionnalité Paramètres SMTP de l'onglet Application sont disponibles dans la section <mailSettings> du fichier Web.config du site Web qui est un enfant de l'élément <system.net> (et non de l'élément <system.web>). Les lignes mises en surbrillance dans le code suivant sont générées suite à l'utilisation de l'outil Administration de site Web pour spécifier des paramètres SMTP.

<configuration>
    <system.net>        <mailSettings>            <smtp>                <network                     host="smtp.myhost.com" />            </smtp>        </mailSettings>    </system.net>
</configuration>

Débogage et traçage

Les paramètres gérés à l'aide de la fonctionnalité Débogage et traçage de l'onglet Application sont disponibles dans les sections <trace>, <compilation> et <customErrors> du fichier Web.config. Le code suivant est un exemple de fichier de configuration qui est généré suite à l'utilisation de l'outil Administration de site Web pour activer le traçage et le débogage et créer une page d'erreurs personnalisée par défaut.

<configuration>
    <system.Web>
        <customErrors defaultRedirect="~/myErrorPage.aspx" />        <trace enabled="True" pageOutput="True" localOnly="True"                 traceMode="SortByCategory"            requestLimit="10" mostRecent="True" />        <compilation debug="True" />
    </system.Web>
</configuration>

Le débogage et le traçage sont activés dans cet exemple, le traçage est affiché dans les pages qui sont demandées à partir du serveur Web uniquement, les résultats du traçage sont triés par catégorie et les 10 plus récents sont mis en cache pour l'affichage. En outre, la page d'erreurs par défaut est myErrorPage.aspx.