Procédure pas à pas : utilisation d’un fichier de configuration pour définir une source de données
Cette procédure pas à pas illustre l’utilisation d’une source de données définie dans un fichier app.config pour les tests unitaires. Vous apprendrez à créer un fichier app.config qui définit une source de données pouvant être utilisée par la classe DataSourceAttribute. Cette procédure pas à pas illustre les tâches suivantes :
Création d’un fichier app.config.
Définition d'une section de configuration personnalisée
Définition de chaînes de connexion
Définition des sources de données
accès aux sources de données à l'aide de la classe DataSourceAttribute.
Notes
DataSourceAttribute est actuellement pris en charge uniquement sur .NET Framework.
Pour exécuter cette procédure pas à pas, vous avez besoin des éléments suivants :
Visual Studio Enterprise
Microsoft Access ou Microsoft Excel afin de fournir des données pour au moins l'une des méthodes de test.
Une solution Visual Studio qui contient un projet de test.
Si votre projet de test contient déjà un fichier app.config, accédez à Définir une section de configuration personnalisée.
Cliquez avec le bouton droit sur votre projet de test dans l’Explorateur de solutions, puis sélectionnez Ajouter>Nouvel élément.
La fenêtre Ajouter un nouvel élément s’ouvre. Si vous ne voyez pas tous les modèles d’élément, choisissez Afficher tous les modèles, puis choisissez le modèle d’élément.
Sélectionnez le modèle Fichier de configuration de l’application, puis cliquez sur Ajouter.
Examinez le fichier app.config. Il contient au moins la déclaration XML et un élément racine.
L’élément racine d’app.config doit être l’élément configuration. Créer un élément configSections dans l’élément configuration. configSections doit être le premier élément du fichier app.config.
Dans l’élément configSections, créez un élément section.
Dans l’élément section, ajoutez un attribut nommé
name
et assignez-lui la valeurmicrosoft.visualstudio.testtools
. Ajoutez un autre attribut nommétype
et assignez-lui la valeurMicrosoft.VisualStudio.TestTools.UnitTesting.TestConfigurationSection, Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions
.
L’élément section doit être similaire à ce qui suit :
<section name="microsoft.visualstudio.testtools" type="Microsoft.VisualStudio.TestTools.UnitTesting.TestConfigurationSection, Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions" />
Notes
Le nom de l’assembly doit correspondre à la version que vous utilisez.
Les chaînes de connexion définissent des informations spécifiques au fournisseur pour accéder aux sources de données. Les chaînes de connexion définies dans les fichiers de configuration fournissent des informations sur le fournisseur de données réutilisables dans une application. Dans cette section, vous créez deux chaînes de connexion qui seront utilisées par des sources de données définies dans la section de configuration personnalisée.
Attention
La chaîne de connexion peut contenir des données sensibles (par exemple, un mot de passe). La chaîne de connexion est stockée en texte brut dans le code source et dans l’assembly compilé. Restreignez l’accès au code source et à l’assembly pour protéger ces informations sensibles.
Après l’élément configSections, créez un élément connectionStrings.
Dans l’élément connectionStrings, créez deux éléments add.
Dans le premier élément add, créez les attributs et valeurs suivants pour une connexion à une base de données Microsoft Access :
Attribut | Valeurs |
---|---|
name |
"MyJetConn" |
connectionString |
"Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\testdatasource.accdb; Persist Security Info=False;" |
providerName |
"System.Data.OleDb" |
Dans le deuxième élément add, créez les attributs et valeurs suivants pour une connexion à une feuille de calcul Microsoft Excel :
Attribut | Valeurs |
---|---|
name |
"MyExcelConn" |
connectionString |
"Dsn=Excel Files;dbq=data.xlsx;defaultdir=.\; driverid=790;maxbuffersize=2048;pagetimeout=5" |
providerName |
"System.Data.Odbc" |
L’élément connectionStrings doit être similaire à ce qui suit :
<connectionStrings>
<add name="MyJetConn" connectionString="Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\testdatasource.accdb; Persist Security Info=False;" providerName="System.Data.OleDb" />
<add name="MyExcelConn" connectionString="Dsn=Excel Files;dbq=data.xlsx;defaultdir=.\; driverid=790;maxbuffersize=2048;pagetimeout=5" providerName="System.Data.Odbc" />
</connectionStrings>
La section de sources de données contient quatre attributs utilisés par le moteur de test pour récupérer des données à partir d'une source de données.
name
définit l'identité utilisée par DataSourceAttribute pour spécifier la source de données à utiliser.connectionString
identifie la chaîne de connexion créée dans la section précédente, Définir des chaînes de connexion.dataTableName
définit la table ou la feuille qui contient les données à utiliser dans le test.dataAccessMethod
définit la technique d'accès aux valeurs de données dans la source de données.
Dans cette section, vous définirez deux sources de données à utiliser dans un test unitaire.
Après l’élément connectionStrings, créez un élément microsoft.visualstudio.testtools. Cette section a été créée dans Définir une section de configuration personnalisée.
Dans l’élément microsoft.visualstudio.testtools, créez un élément dataSources.
Dans l’élément dataSources, créez deux éléments add.
Dans le premier élément add, créez les attributs et valeurs suivants pour une source de données Microsoft Access :
Attribut | Valeurs |
---|---|
name |
"MyJetDataSource" |
connectionString |
"MyJetConn" |
dataTableName |
"MyDataTable" |
dataAccessMethod |
"Sequential" |
Dans le deuxième élément add, créez les attributs et valeurs suivants pour une source de données Microsoft Excel :
Attribut | Valeurs |
---|---|
Name |
"MyExcelDataSource" |
connectionString |
"MyExcelConn" |
dataTableName |
"Sheet1$" |
dataAccessMethod |
"Sequential" |
L’élément microsoft.visualstudio.testtools doit être similaire à ce qui suit :
<microsoft.visualstudio.testtools>
<dataSources>
<add name="MyJetDataSource" connectionString="MyJetConn" dataTableName="MyDataTable" dataAccessMethod="Sequential"/>
<add name="MyExcelDataSource" connectionString="MyExcelConn" dataTableName="Sheet1$" dataAccessMethod="Sequential"/>
</dataSources>
</microsoft.visualstudio.testtools>
Le fichier app.config final doit ressembler à ceci :
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="microsoft.visualstudio.testtools" type="Microsoft.VisualStudio.TestTools.UnitTesting.TestConfigurationSection, Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions" />
</configSections>
<connectionStrings>
<add name="MyJetConn" connectionString="Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\testdatasource.accdb; Persist Security Info=False;" providerName="System.Data.OleDb" />
<add name="MyExcelConn" connectionString="Dsn=Excel Files;dbq=data.xlsx;defaultdir=.\; driverid=790;maxbuffersize=2048;pagetimeout=5" providerName="System.Data.Odbc" />
</connectionStrings>
<microsoft.visualstudio.testtools>
<dataSources>
<add name="MyJetDataSource" connectionString="MyJetConn" dataTableName="MyDataTable" dataAccessMethod="Sequential"/>
<add name="MyExcelDataSource" connectionString="MyExcelConn" dataTableName="Sheet1$" dataAccessMethod="Sequential"/>
</dataSources>
</microsoft.visualstudio.testtools>
</configuration>
Maintenant qu’un fichier app.config a été défini, vous allez créer un test unitaire qui utilise des données situées dans les sources de données définies dans le fichier app.config. Dans cette section, nous allons :
créer les sources de données du fichier app.config ;
utiliser les sources de données dans deux méthodes de test qui comparent les valeurs dans chaque source de données.
Créez une base de données Microsoft Access nommée testdatasource.accdb.
Créez une table et nommez-la
MyDataTable
dans testdatasource.accdb.Créez deux champs dans
MyDataTable
nommésArg1
etArg2
à l'aide du type de donnéesNumber
.Ajoutez cinq entités à
MyDataTable
avec les valeurs suivantes pourArg1
etArg2
, respectivement : (10,50), (3,2), (6,0), (0,8) et (12312,1000).Enregistrez et fermez la base de données.
Modifiez la chaîne de connexion de sorte qu'elle pointe vers l'emplacement de la base de données. Modifiez la valeur de
Data Source
pour refléter l'emplacement de la base de données.
Créez une feuille de calcul Microsoft Excel nommée data.xlsx.
Créez une feuille nommée
Sheet1
si elle n’existe pas déjà dans data.xlsx.Créez deux en-têtes de colonnes et nommez-les
Val1
etVal2
dansSheet1
.Ajoutez cinq entités à
Sheet1
avec les valeurs suivantes pourVal1
etVal2
, respectivement : (1,1), (2,2), (3,3), (4,4) et (5,0).Enregistrez et fermez la feuille de calcul.
Modifiez la chaîne de connexion de sorte qu'elle pointe vers l'emplacement de la feuille de calcul. Modifiez la valeur de
dbq
pour refléter l'emplacement de la feuille de calcul.
Ajoutez un test unitaire au projet de test.
Remplacez le contenu généré automatiquement du test unitaire par le code suivant :
using System; using Microsoft.VisualStudio.TestTools.UnitTesting; namespace TestProject1 { [TestClass] public class UnitTest1 { private TestContext context; public TestContext TestContext { get { return context; } set { context = value; } } [TestMethod()] [DeploymentItem("MyTestProject\\testdatasource.accdb")] [DataSource("MyJetDataSource")] public void MyTestMethod() { int a = Int32.Parse(context.DataRow["Arg1"].ToString()); int b = Int32.Parse(context.DataRow["Arg2"].ToString()); Assert.AreNotEqual(a, b, "A value was equal."); } [TestMethod()] [DeploymentItem("MyTestProject\\data.xlsx")] [DataSource("MyExcelDataSource")] public void MyTestMethod2() { Assert.AreEqual(context.DataRow["Val1"], context.DataRow["Val2"]); } } }
Examinez les attributs DataSource. Notez les noms des paramètres à partir du fichier app.config.
Générez votre solution et exécutez les tests MyTestMethod et MyTestMethod2.
Important
Déployez des éléments tels que des sources de données de sorte qu'ils soient accessibles au test dans le répertoire de déploiement.