Tutorial: Utilizar un archivo de configuración para definir un origen de datos

Artículo
03/13/2023

Este tutorial muestra cómo usar un origen de datos definido en un archivo app.config para pruebas unitarias. Aprenderá a crear un archivo app.config que define un origen de datos que se puede usar en la clase DataSourceAttribute. En este tutorial se presentan las tareas siguientes:

Creación de un archivo app.config.
Definición de una sección de configuración personalizada.
Definición de cadenas de conexión.
Definición de orígenes de datos.
Acceso a los orígenes de datos mediante la clase DataSourceAttribute.

Nota

DataSourceAttribute solo se admite en estos momentos en .NET Framework.

Prerrequisitos

Para completar este tutorial, necesita lo siguiente:

Visual Studio Enterprise
Que Microsoft Access o Microsoft Excel proporcione datos para al menos uno de los métodos de prueba.
Una solución de Visual Studio que contenga un proyecto de prueba.

Agregar un archivo app.config al proyecto

Si el proyecto de prueba ya incluye un archivo app.config, vaya a Definir una sección de configuración personalizada.
En el Explorador de soluciones, haga clic con el botón derecho en el proyecto de prueba y luego seleccione Agregar>Nuevo elemento.

Se abrirá la ventana Agregar nuevo elemento. Si no ve todas las plantillas de elemento, seleccione Mostrar todas las plantillas y elija la plantilla de elemento.
Seleccione la plantilla Archivo de configuración de aplicaciones y haga clic en Agregar.

Definir una sección de configuración personalizada

Examine el archivo app.config. Debe contener al menos la declaración XML y un elemento raíz.

Para agregar la sección de configuración personalizada al archivo app.config

El elemento raíz de app.config debe ser el elemento configuration. Crear un elemento configSections dentro del elemento configuration. El elemento configSections debe ser el primero en el archivo app.config.
En el elemento configSections, cree un elemento section.
En el elemento section, agregue un atributo denominado name y asígnele un valor igual a microsoft.visualstudio.testtools. Agregue otro atributo denominado type y asígnele un valor de Microsoft.VisualStudio.TestTools.UnitTesting.TestConfigurationSection, Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions.

El elemento section debe ser similar a este:

<section name="microsoft.visualstudio.testtools" type="Microsoft.VisualStudio.TestTools.UnitTesting.TestConfigurationSection, Microsoft.VisualStudio.TestPlatform.TestFramework.Extensions" />

Nota

El nombre del ensamblado debe coincidir con la versión que se esté usando.

Definir cadenas de conexión

Las cadenas de conexión definen la información específica del proveedor para acceder a los orígenes de datos. Las cadenas de conexión definidas en los archivos de configuración proporcionan información del proveedor de datos reutilizable en una aplicación. En esta sección, creará dos cadenas de conexión para que las usen los orígenes de datos definidos en la sección de configuración personalizada.

Para definir cadenas de conexión:

Después del elemento configSections, cree un elemento connectionStrings.
En el elemento connectionStrings, cree dos elementos add.
En el primer elemento add, cree los atributos y los valores siguientes para una conexión con una base de datos de Microsoft Access:

Atributo	Valores
`name`	`"MyJetConn"`
`connectionString`	`"Provider=Microsoft.Jet.OLEDB.4.0; Data Source=C:\testdatasource.accdb; Persist Security Info=False;"`
`providerName`	`"System.Data.OleDb"`

En el segundo elemento add, cree los atributos y los valores siguientes para una conexión con una hoja de cálculo de Microsoft Excel:

Atributo	Valores
`name`	`"MyExcelConn"`
`connectionString`	`"Dsn=Excel Files;dbq=data.xlsx;defaultdir=.\; driverid=790;maxbuffersize=2048;pagetimeout=5"`
`providerName`	`"System.Data.Odbc"`

Este elemento connectionStrings debe ser similar a este:

<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>

Definir orígenes de datos

La sección de orígenes de datos contiene cuatro atributos con los que el motor de pruebas recuperará los datos de un origen de datos.

name define la identidad con la que DataSourceAttribute especifica el origen de datos que se debe usar.
connectionString identifica la cadena de conexión que ha creado en la sección Definir cadenas de conexión anterior.
dataTableName define la tabla o la hoja que contiene los datos que se van a usar en la prueba.
dataAccessMethod define la técnica para acceder a los valores de datos del origen de datos.

En esta sección, definirá dos orígenes de datos que se usarán en una prueba unitaria.

Para definir orígenes de datos:

Después del elemento connectionStrings, cree un elemento microsoft.visualstudio.testtools. El contenido de esta sección ya se ha creado en Definir una sección de configuración personalizada.
En el elemento microsoft.visualstudio.testtools, cree un elemento dataSources.
En el elemento dataSources, cree dos elementos add.
En el primer elemento add, cree los atributos y los valores siguientes para un origen de datos de Microsoft Access:

Atributo	Valores
`name`	`"MyJetDataSource"`
`connectionString`	`"MyJetConn"`
`dataTableName`	`"MyDataTable"`
`dataAccessMethod`	`"Sequential"`

En el segundo elemento add, cree los atributos y los valores siguientes para un origen de datos de Microsoft Excel:

Atributo	Valores
`Name`	`"MyExcelDataSource"`
`connectionString`	`"MyExcelConn"`
`dataTableName`	`"Sheet1$"`
`dataAccessMethod`	`"Sequential"`

El elemento microsoft.visualstudio.testtools debe ser similar al siguiente:

<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>

El archivo app.config final debe ser similar a este:

<?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>

Crear una prueba unitaria que use los orígenes de datos definidos en app.config

Una vez definido el archivo app.config, deberá crear una prueba unitaria que use los datos ubicados en los orígenes de datos definidos en dicho archivo. En esta sección, haremos lo siguiente:

Creará los orígenes de datos que se encuentran en el archivo app.config.
Usará los orígenes de datos en dos métodos de prueba que comparan los valores de cada uno de estos orígenes.

Para crear un origen de datos de Microsoft Access:

Cree una base de datos de Microsoft Access denominada testdatasource.accdb.
Cree una tabla y asígnele el nombre MyDataTable en testdatasource.accdb.
Cree dos campos en MyDataTable denominados Arg1 y Arg2 con el tipo de datos Number.
Agregue cinco entidades a MyDataTable con los valores siguientes para Arg1 y Arg2 respectivamente: (10,50), (3,2), (6,0), (0,8) y (12312,1000).
Guarde y cierre la base de datos.
Cambie la cadena de conexión para que apunte a la ubicación de la base de datos. Cambie el valor de Data Source para que refleje la ubicación de la base de datos.

Para crear un origen de datos de Microsoft Excel:

Cree una hoja de cálculo de Microsoft Excel denominada data.xlsx.
Cree una hoja denominada Sheet1 si no existe en data.xlsx.
Cree dos encabezados de columna y asígneles los nombres de Val1 y Val2 en Sheet1.
Agregue cinco entidades a Sheet1 con los valores siguientes para Val1 y Val2 respectivamente: (1,1), (2,2), (3,3), (4,4) y (5,0).
Guarde y cierre la hoja de cálculo.
Cambie la cadena de conexión para que apunte a la ubicación de la hoja de cálculo. Cambie el valor de dbq para que refleje la ubicación de la hoja de cálculo.

Para crear una prueba unitaria con los orígenes de datos de app.config:

Agregue una prueba unitaria al proyecto de prueba.

Reemplace el contenido de la prueba unitaria generado automáticamente por el código siguiente:

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"]);
        }
    }
}

Examine los atributos DataSource. Observe los nombres de configuración del archivo app.config.
Compile la solución y ejecute las pruebas MyTestMethod y MyTestMethod2.

Importante

Implemente los elementos como los orígenes de datos, para que la prueba pueda acceder a ellos en el directorio de implementación.

Compartir a través de

Tutorial: Utilizar un archivo de configuración para definir un origen de datos

Prerrequisitos

Agregar un archivo app.config al proyecto

Definir una sección de configuración personalizada

Para agregar la sección de configuración personalizada al archivo app.config

Definir cadenas de conexión

Para definir cadenas de conexión:

Definir orígenes de datos

Para definir orígenes de datos:

Crear una prueba unitaria que use los orígenes de datos definidos en app.config

Para crear un origen de datos de Microsoft Access:

Para crear un origen de datos de Microsoft Excel:

Para crear una prueba unitaria con los orígenes de datos de app.config:

Comentarios

Comentarios

Recursos adicionales

Compartir a través de

Tutorial: Utilizar un archivo de configuración para definir un origen de datos

Prerrequisitos

Agregar un archivo app.config al proyecto

Definir una sección de configuración personalizada

Para agregar la sección de configuración personalizada al archivo app.config

Definir cadenas de conexión

Para definir cadenas de conexión:

Definir orígenes de datos

Para definir orígenes de datos:

Crear una prueba unitaria que use los orígenes de datos definidos en app.config

Para crear un origen de datos de Microsoft Access:

Para crear un origen de datos de Microsoft Excel:

Para crear una prueba unitaria con los orígenes de datos de app.config:

Contenido relacionado

Comentarios

Comentarios

Recursos adicionales