Partage via


SectionInformation.ConfigSource Propriété

Définition

Obtient ou définit le nom du fichier Include dans lequel la section de configuration associée est définie, si ce fichier existe.

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };
public string ConfigSource { get; set; }
member this.ConfigSource : string with get, set
Public Property ConfigSource As String

Valeur de propriété

Nom du fichier Include dans lequel le ConfigurationSection associé est défini, si ce fichier existe ; sinon, une chaîne vide ("").

Remarques

La ConfigSource propriété représente la valeur de l’attribut configSource spécifié pour un ConfigurationSection objet associé à l’objet SectionInformation .

Une ConfigurationSection implémentation peut éventuellement spécifier un fichier distinct dans lequel les paramètres de configuration de cette section sont définis. Cela peut être utile de plusieurs façons :

  • L’utilisation de fichiers include peut entraîner une structure plus logique et modulaire pour les fichiers de configuration.

  • La sécurité et les autorisations d’accès aux fichiers peuvent être utilisées pour restreindre l’accès aux sections des paramètres de configuration.

  • Les paramètres d’un fichier include qui ne sont pas utilisés lors de l’initialisation de l’application peuvent être modifiés et rechargés sans nécessiter de redémarrage de l’application.

L’exemple suivant montre comment cet attribut est utilisé dans un fichier de configuration pour spécifier que la pages section est définie dans un fichier include externe :

<pages configSource="pages.config"/>

Si l’un des paramètres d’un fichier include de configuration nécessite que l’application redémarre lorsqu’il est modifié, définissez la propriété sur RestartOnExternalChangestrue.

Dans ASP.NET applications, au moment de l’exécution, vous pouvez affecter à la ConfigSource propriété le nom d’un autre fichier de configuration. Dans ce cas, le contenu du fichier est remplacé par les informations par défaut chaîne de connexion contenues dans le fichier Web.config. Cela se produit également lorsque le fichier alternatif n’existe pas et qu’il est créé au moment de l’exécution. Si le fichier Web.config ne contient pas d’informations chaîne de connexion, une section vide est ajoutée au fichier de remplacement.

S’applique à

Voir aussi