connectionStrings, élément (Schéma des paramètres ASP.NET)

  • Article

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Spécifie une collection de chaînes de connexion à une base de données, sous la forme de paires nom/valeur, pour les applications et les fonctionnalités ASP.NET.

Cet élément est une nouveauté du .NET Framework version 2.0.

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents pour cet élément.

Attributs

Aucun, à l'exception des attributs hérités par tous les éléments section. Pour plus d'informations, consultez Attributs généraux hérités par les éléments Section. Dans les applications ASP.NET, au moment du runtime, vous pouvez assigner à l'attribut ConfigSource un nom d'un autre fichier de configuration. Dans ce cas, le contenu du fichier est remplacé par les informations de la chaîne de connexion par défaut contenues dans le fichier Web.config. Cela se produit également lorsque l'autre fichier n'existe pas et est créé au moment de l'exécution. Si le fichier Web.config ne contient pas d'informations de la chaîne de connexion, une section connectionStrings vide est ajoutée au fichier de remplacement.

Éléments enfants

Élément

Description

Add

Ajoute une chaîne de connexion en tant que paire nom/valeur à la collection de chaînes de connexion.

Clear

Supprime toutes les références aux chaînes de connexion héritées, n'autorisant que les chaînes de connexion ajoutées par l'élément add actuel.

remove

Supprime une référence à une chaîne de connexion héritée de la collection de chaînes de connexions.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

System.web

Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

Notes

L'élément connectionStrings spécifie une collection de chaînes de connexion à une base de données, sous la forme de paires nom/valeur, pour les applications et les fonctionnalités ASP.NET.

Dans les versions antérieures d'ASP.NET, les chaînes de connexion étaient stockées dans appSettings. Dans ASP.NET 2.0, des fonctionnalités comme Session, Appartenance, Personnalisation et Gestionnaire de rôles reposent sur les chaînes de connexion stockées dans l'élément connectionStrings. Vous pouvez également utiliser l'élément connectionStrings pour stocker des chaînes de connexion pour vos propres applications.

Configuration par défaut

Les chaînes de connexion contenues dans un fichier de configuration parent sont héritées, sauf si l'élément clear est utilisé dans le fichier de configuration enfant. L'élément connectionStrings par défaut suivant est configuré dans le fichier Machine.config.

Vous pouvez accéder à l'élément connectionStrings par programme. Pour plus d'informations, consultez l'exemple ConnectionStrings.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

Exemple

L'exemple de code suivant montre comment configurer deux chaînes de connexion. La première chaîne de connexion peut être utilisée par une application ASP.NET et la seconde est utilisée par l'élément sqlCacheDependency, qui est configuré ultérieurement.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

ConnectionStringsSection

Membre de configuration

ConnectionStringSettingsCollection

ConnectionStrings

ConnectionStrings

ConnectionStrings

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

How to: Lock ASP.NET Configuration Settings

Référence

configuration, élément (Schéma des paramètres généraux)

add, élément de connectionStrings (Schéma des paramètres ASP.NET)

clear, élément de connectionStrings (Schéma des paramètres ASP.NET)

remove, élément de connectionStrings (Schéma des paramètres ASP.NET)

Concepts

ASP.NET Configuration Overview

Securing Configuration

ASP.NET Data Access Overview

Installing the SQL Server Provider Database

Securing Data Access

Autres ressources

Paramètres de configuration ASP.NET