add, élément de connectionStrings (Schéma des paramètres ASP.NET)
[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.]
Ajoute une chaîne de connexion en tant que paire nom/valeur à la collection de chaînes de connexion.
Cet élément est une nouveauté du .NET Framework version 2.0.
<add
name="connection string name"
connectionString="connection string"
providerName="ADO.NET data provider"
/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
---|---|
connectionString |
Attribut String requis. Définit la valeur de la chaîne de connexion. La valeur peut être une chaîne vide (""). Aucune vérification n'est effectuée pour vérifier sa validité. La valeur par défaut est une chaîne vide (""). |
name |
Attribut String requis. Définit la clé à utiliser pour accéder à la valeur de la chaîne de connexion. Cet attribut se substitue à toute clé héritée portant le même nom. La valeur par défaut est une chaîne vide (""). |
providerName |
Attribut String facultatif. Nom du fournisseur ADO.NET à utiliser pour accéder au magasin de données sous-jacent. La valeur par défaut est "System.Data.SqlClient". |
Attributs hérités |
Attributs facultatifs. 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. |
Éléments enfants
Aucun
É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. |
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. |
Notes
L'élément add ajoute une chaîne de connexion en tant que paire nom/valeur à la collection de chaînes de connexion de l'élément connectionStrings.
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.
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 element par défaut suivant est configuré dans le fichier Machine.config.
<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 une chaîne de connexion pour une application qui utilise la base de données Northwind.
<configuration>
<connectionStrings>
<add name="Northwind"
connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
providerName="System.Data.SqlClient" />
</connectionStrings>
</configuration>
Informations sur les éléments
Gestionnaire de section de configuration |
|
Membre de configuration |
|
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
clear, élément de connectionStrings (Schéma des paramètres ASP.NET)
configuration, élément (Schéma des paramètres généraux)
clear, élément de connectionStrings (Schéma des paramètres ASP.NET)
remove, élément de connectionStrings (Schéma des paramètres ASP.NET)