INFO : ASP.NET Configuration Overview

Traductions disponibles Traductions disponibles
Numéro d'article: 307626 - Voir les produits auxquels s'applique cet article
Cet article fait référence à Microsoft suivant.NET Framework équivalente Espace de noms de bibliothèque :
  • System.Configuration
Agrandir tout | Réduire tout

Sommaire

Résumé

Cet article fournit une introduction à l'ASP.NET page Framework.

Pour plus d'ASP.NET, reportez-vous à la suivante Article de la Base de connaissances Microsoft :
305140 INFO : ASP.NET Roadmap

Plus d'informations

Configuration regroupe tout à partir des paramètres d'application telles que les connexions de base de données pour des détails sur la sécurité et des informations sur la façon les erreurs doivent être gérées. Fichiers de configuration fournissent un emplacement pour informations spécifiques à l'ordinateur et spécifiques à l'application que vous pouvez modifier sans avoir à recompiler le code.

Cet article aborde les rubriques de configuration suivantes :

Configuration : Nouveautés

Contrairement aux paramètres de l'application Active Server Pages (ASP) qui sont stockés dans le de Microsoft Internet Information Services Métabase (IIS), ASP.NET est stockés dans Extensible Markup Language Fichiers Language (XML). Ceci offre les avantages suivants lorsque vous avez besoin modifier les paramètres de configuration et déploiement d'applications :
  • ASP.Fichiers de configuration NET sont stockés dans le même répertoire que le contenu du site. Au moment du déploiement, il vous souhaitez de copier le répertoire de contenu pour obtenir le contenu et l'application configuration.
  • Vous pouvez utiliser les éditeurs de texte standard pour modifier la configuration fichiers. Cela facilite la modification des paramètres de configuration localement et à distance.
  • Les fichiers de configuration sont extensibles ; par conséquent, vous pouvez ajouter vos propres paramètres de configuration personnalisés.
  • Le système détecte automatiquement les modifications apportées à ASP.NET fichiers de configuration. Vous n'avez pas à redémarrer les services IIS ou redémarrer le serveur Web Pour que les paramètres prennent effet.

Format de fichier et la hiérarchie de Configuration

Il existe deux types de fichiers de configuration qui vous convient être concerné d'ASP.NETTE applications : Machine.config et Web.config. Les deux les fichiers sont basés sur XML et contiennent des sections de configuration similaires. Toutefois, le Fichier machine.config contient des informations de configuration sur tous.NET applications pour une version spécifique du cadre, considérant que le fichier Web.config les fichiers contiennent les paramètres de configuration plus granulaires sur les pages ASP spécifique.NET applications. Le texte dans les fichiers Machine.config et Web.config est la casse.

Pour plus d'informations sur le format d'ASP.NET fichiers de configuration, reportez-vous à la rubrique suivante dans le.NET Framework Documentation du Kit de développement (SDK) de logiciel :
Format d'ASP.Fichiers de Configuration NET
http://msdn2.Microsoft.com/en-us/library/ackhksh7 (vs.71) .aspx
Lorsqu'une demande pour une page .aspx est effectuée, les fichiers de configuration sont compilées de manière à qui un paramètre de configuration dans un fichier Web.config qui est stocké dans un substitutions sous-répertoire de fichiers un paramètre dans un fichier Web.config dans une répertoire de l'application, qui remplace les paramètres au niveau du site Web et paramètres dans le fichier Machine.config. Une fois les paramètres de configuration sont compilé, ils sont mis en cache pour les demandes ultérieures jusqu'à ce qu'un de la configuration fichiers est modifié.

Le tableau suivant répertorie la configuration de l'échantillon emplacements des fichiers pour la http://myserver/myapplication/mydir/mypage.aspx URL :

Réduire ce tableauAgrandir ce tableau
NiveauChemin d'accès
Paramètres de configuration pour cette version de la.NET FrameworkWinnt\Microsoft.net\Framework\v.version\CONFIG\Machine.config
Paramètres du site WebInetpub\Wwwroot\Web.config
Application paramètresInetpub\Wwwroot\Myapplication\Web.config
Sous-répertoire paramètresInetpub\Wwwroot\Myapplication\Mydir\Web.config

Un fichier Web.config n'importe quel niveau est facultatif, mais un Le fichier machine.config est requis.

Pour plus d'informations sur hiérarchie de configuration, reportez-vous à la rubrique suivante dans le.NET Framework SDK documentation :
Architecture de Configuration hiérarchique
http://msdn.Microsoft.com/en-us/library/aa720128 (v=vs.71) .aspx
Pour appliquer les paramètres de configuration à des ressources spécifiques, utilisez un <location></location> balise avec un attribut path approprié. Vous pouvez utiliser le chemin d'accès attribut pour identifier un répertoire de fichier ou un enfant spécifique auquel unique appliqueront des paramètres de configuration.

Pour plus d'informations sur le <location></location> de la balise, reportez-vous à la rubrique suivante dans le.NET Framework SDK documentation :
<Location>Paramètres de configuration
</Location>http://msdn.Microsoft.com/en-us/library/6hbkh9s7 (v=vs.71) .aspx

ASP.Sections de Configuration NET

L'appartenance d'ASP.Sections de configuration NET sont contenues dans le <system.web></system.web> section, qui est contenue dans la <configuration></configuration> tag :
   <configuration>
      <appSettings></appSettings>
      <system.web>
         ...
         <webServices></webServices>
      </system.web>
   </configuration>
				
Le tableau suivant répertorie toutes les applications ASP..NETTE configuration sections :

Réduire ce tableauAgrandir ce tableau
SectionDescription
<appSettings></appSettings>Configure paramètres personnalisés pour une application. Les paramètres de cette section peuvent être par rapport aux variables d'application.
<authentication></authentication>Configure le mode d'authentification pour déterminer le type d'authentification à utiliser.
<authorization></authorization>Configure l'autorisation prend en charge et contrôle l'accès client aux ressources URL.
<browserCaps></browserCaps>Configure les paramètres du composant browser capabilities.
<compilation></compilation>Configure tous les paramètres de compilation qu'ASP.NET utilise.
<customErrors></customErrors>Fournit des informations sur les messages d'erreur personnalisés pour une application ASP..NETTE application.
<globalization></globalization>Configure les paramètres de globalisation de l'application.
<httpHandlers></httpHandlers>Cartes demandes d'URL entrantes aux classes IHttpHandler .
<httpModules></httpModules>Ajoute, supprime ou efface des modules HTTP au sein d'une application.
<httpRuntime></httpRuntime>Configure ASP.Paramètres d'exécution HTTP NET.
<identity></identity>Contrôles l'identité de l'application Web.
<machineKey></machineKey>Configure touches à utiliser pour le chiffrement et déchiffrement des données de cookie d'authentification de formulaires. Cette section vous permet de configurer une clé de validation qui exécute message l'authentification vérifie sur les données d'état d'affichage et tickets d'authentification de formulaires.
<pages></pages>Identifie paramètres de configuration spécifiques à la page.
<processModel></processModel>Configure l'appartenance d'ASP.NET spécifiques sur les systèmes de serveur Web IIS. Notez que vous pouvez Utilisez uniquement cette balise dans le fichier Machine.config.
<securityPolicy></securityPolicy>Définit les mappages valides de niveaux de sécurité nommé aux fichiers de stratégie.
<sessionState></sessionState>Configure le module d'état de session.
<trace></trace>Configure l'appartenance d'ASP.Service NET trace.
<trust></trust>Configure le jeu d'autorisations de sécurité d'accès au code qui est utilisé pour exécuter un particulier application.
<webServices></webServices>Contrôles les paramètres d'ASP.NET Web Services.

Récupération des informations de Configuration

Vous pouvez récupérer les informations stockées dans la configuration fichier, mais les méthodes varient selon les paramètres de configuration différents. Certains paramètres sont exposées comme propriétés de les objets intrinsèques et les autres paramètres ne sont pas accessibles car ils sont paramètres internes d'ASP.NET.

Par exemple, vous pouvez utiliser les éléments suivants le code pour accéder à la <browserCaps></browserCaps> paramètres via l'objet Request.Browser :

Microsoft Visual Basic.NET
Response.Write(Request.Browser.VBScript.ToString())
				
Microsoft Visual c#.NET
Response.Write(Request.Browser.VBScript.ToString());
				
Pour plus d'informations sur la façon de récupérer les paramètres de configuration, reportez-vous à la rubrique suivante dans le.NET Framework suivante :
L'accès aux paramètres de Configuration
http://msdn.Microsoft.com/en-us/library/4c2kcht0.aspx

Extension de la Section de Configuration

Le fichier.Fonctionnalité de configuration NET Framework est entièrement extensible. Il existe deux façons dans laquelle vous pouvez étendre la configuration :
  • Créer un gestionnaire de section de configuration personnalisée.

    Pour les autres informations sur la façon de créer des contrôles serveur ASP.Gestionnaires de section de configuration NET Cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la base de connaissances Microsoft Base :
    309045 Comment : Créer une page ASP..Gestionnaire de Section de Configuration NET dans Visual c#.NET
  • Utilisez le <appSettings></appSettings> section pour stocker des données spécifiques d'application. Pour plus d'informations sur la syntaxe de la <appSettings></appSettings> section, reportez-vous à la rubrique suivante dans le.NET Framework SDK documentation :
    http://msdn.Microsoft.com/en-us/library/aa903313 (v=vs.71) .aspx
    Pour récupérer des valeurs à partir de la <appSettings></appSettings> section, utilisez le code suivant dans le fichier .config :
            <appSettings>
    		<add key="MySetting" value="Valuable Information" />
            </appSettings>
    						
    Utilisez ensuite le code suivant pour récupérer la valeur :

    Remarque: vous devez inclure l'espace de noms System.Configuration pour accéder aux appSettings.

    Visual Basic .NET
        Label1.Text = ConfigurationSettings.AppSettings.Item("MySetting")
    					
    Visual c#.NET
        Label1.Text = ConfigurationSettings.AppSettings["MySetting"];
    					

Propriétés

Numéro d'article: 307626 - Dernière mise à jour: mercredi 20 juin 2012 - Version: 1.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft ASP.NET 1.0
  • Microsoft ASP.NET 1.1
Mots-clés : 
kbproductlink kbarttyperoadmap kbconfig kbinfo kbweb kbmt KB307626 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 307626
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