Cómo: Crear una prueba unitaria controlada por datos
Mediante el marco de pruebas unitarias de Microsoft para el código administrado, se puede configurar un método de pruebas unitarias para recuperar los valores utilizados en el método de un origen de datos.El método se ejecuta consecutivamente para cada fila del origen de datos, que facilita probar una variedad de entradas utilizando un único método.
Este tema contiene las siguientes secciones:
Crear una prueba unitaria controlada por datos implica los pasos siguientes:
Crear un origen de datos que contiene los valores que se utilizan en el método de prueba.El origen de datos puede ser cualquier tipo registrado en el equipo que ejecuta la prueba.
Agregue un campo privado TestContext y una propiedad pública TestContext a la clase de prueba.
Cree un método de prueba unitaria y agregue un atributo DataSourceAttribute a ésta.
Utilice la propiedad de indizador DataRow para recuperar los valores que se utilizan en una prueba.
El método en pruebas
Como ejemplo, supongamos que hemos creado:
Una solución denominada MyBank que acepta y procesa las transacciones para distintos tipos de cuentas.
Un proyecto en MyBank denominado BankDb que administra las transacciones de las cuentas.
Una clase denominada Maths en el proyecto DbBank que realiza las funciones matemáticas para asegurarse de que cualquier transacción es ventajosa para el banco.
Un proyecto de pruebas unitarias denominado BankDbTests para probar el comportamiento del componente BankDb .
Una clase de pruebas unitarias denominada MathsTests para comprobar el comportamiento de la clase Maths .
Probaremos un método en Maths que agregue dos enteros utilizando un bucle:
public int AddIntegers(int first, int second)
{
int sum = first;
for( int i = 0; i < second; i++)
{
sum += 1;
}
return sum;
}
Crear un origen de datos
Para probar el método AddIntegers , creamos un origen de datos que especifique un intervalo de valores para los parámetros y la suma que espera devolverse.En nuestro ejemplo, creamos un acuerdo MathsData denominado base de datos de SQL y una tabla denominada AddIntegersData que contiene los nombres de columna y los valores siguientes
FirstNumber |
SecondNumber |
Sum |
|---|---|---|
0 |
1 |
1 |
1 |
1 |
2 |
2 |
-3 |
-1 |
Agregar un TestContext a la clase de prueba
El marco de pruebas unitarias crea un objeto TestContext para almacenar información de origen de datos para una prueba controlada por datos.El marco, a continuación, establece este objeto como valor de la propiedad TestContext que creamos.
private TestContext testContextInstance;
public TestContext TestContext
{
get { return testContextInstance; }
set { testContextInstance = value; }
}
En el método de prueba, se tiene acceso a los datos a través de la propiedad de indizador DataRow de TestContext.
Escritura del método de prueba
El método de prueba para AddIntegers es bastante simple.Para cada fila del origen de datos, denominamos AddIntegers con los valores de columna de FirstNumber y de SecondNumber como parámetros y comprobamos el valor devuelto con valor de columna de suma :
[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0; Data Source=C:\Data\MathsData.sdf;", "Numbers")]
[TestMethod()]
public void AddIntegers_FromDataSourceTest()
{
var target = new Maths();
// Access the data
int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);
int y = Convert.ToInt32(TestContext.DataRow["SecondNumber"]);
int expected = Convert.ToInt32(TestContext.DataRow["Sum"]);
int actual = target.IntegerMethod(x, y);
Assert.AreEqual(expected, actual,
"x:<{0}> y:<{1}>",
new object[] {x, y});
}
Observe que el método Assert incluye un mensaje que muestra los valores x e y de una iteración errónea.De forma predeterminada, los valores afirmados, expected y actual, están ya incluidos en los detalles de una prueba no superada.
.gif "ms182527.collapse_all(es-es,VS.110).gif")
Especificar el DataSourceAttribute
El atributo DataSource especifica la cadena de conexión para el origen de datos y el nombre de la tabla que se utiliza en el método de prueba.La información exacta de la cadena de conexión varía, dependiendo de qué tipo de origen de datos se utilice.En este ejemplo, utilizamos una base de datos SqlServerCe.
[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0;Data Source=C:\Data\MathsData.sdf", "AddIntegersData")]
El atributo DataSource tiene tres constructores.
[DataSource(dataSourceSettingName)]
Un constructor con un parámetro utiliza la información de conexión que se almacena en el archivo app.config para la solución.El dataSourceSettingsName es el nombre del elemento XML en el archivo de configuración que especifica la información de conexión.
Mediante un archivo app.config se permite cambiar la ubicación del origen de datos sin realizar cambios en la propia prueba unitaria.Para obtener información sobre cómo crear y utilizar un archivo app.config, consulte Tutorial: Utilizar un archivo de configuración para definir un origen de datos.
[DataSource(connectionString, tableName)]
El constructor DataSource con dos parámetros especifica la cadena de conexión para el origen de datos y el nombre de la tabla que contiene los datos para el método de prueba.
Las cadenas de conexión dependen del tipo de origen de datos, pero debe contener un elemento del proveedor que especifique el nombre invariable del proveedor de datos.
[DataSource(
dataProvider,
connectionString,
tableName,
dataAccessMethod
)]
Mediante TestContext.DataRow para tener acceso a los datos
Para tener acceso a los datos en AddIntegersData, utilice el indizador de TestContext.DataRow .DataRow es un objeto DataRow , por lo que recuperamos valores de columnas por índice o nombres de columna.Dado que los valores se devuelven como objetos, necesitamos convertirlos al tipo adecuado:
int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);
Ejecutar pruebas y ver los resultados
Cuando termine de escribir un método de prueba, compile el proyecto de prueba.El método de prueba aparece en la ventana del Explorador de pruebas en el grupo de Pruebas no ejecutadas .A medida que ejecuta, escribe y vuelve a ejecutar las pruebas, el Explorador de pruebas muestra los resultados en los grupos Pruebas no superadas, Pruebas superadas y Pruebas no ejecutadas.Se puede elegir Ejecutar todas para ejecutar todas las pruebas, o elegir Ejecutar... para elegir un subconjunto de pruebas para ejecutarse.
La barra de lresultados de pruebas en la parte superior del Explorador se anima a medida que se ejecutan las pruebas.Al final de la ejecución de pruebas, la barra se vuelve verde si todas las pruebas se han superado o roja si no se ha superado cualquiera de las pruebas.Un resumen de la ejecución de pruebas aparece en el panel de detalles en la parte inferior de la ventana del Explorador de pruebas.Seleccione una prueba para ver los detalles de esa prueba en la sección inferior.
Si ejecutó el método AddIntegers_FromDataSourceTest en nuestro ejemplo, la barra de resultados cambia a color rojo y el método de prueba se mueve a los errores dirigidos por datos a la prueba de Pruebas no superadas si hay métodos iterados cualquiera de los del origen de datos.Cuando se elige una prueba controlada por datos incorrectos en la ventana del Explorador de pruebas, el panel de detalles muestra los resultados de cada iteración que se identifica mediante el índice de la fila de datos.En nuestro ejemplo, aparecerá que el algoritmo AddIntegers no controla los valores negativos correctamente.
Cuando el método en pruebas es corregido y se vuelven a ejecutar las pruebas, la barra de resultados se vuelve verde y el método de pruebas se mueve al grupo Pruebas superadas .
Vea también
Referencia
Microsoft.VisualStudio.TestTools.UnitTesting.DataSourceAttribute
Microsoft.VisualStudio.TestTools.UnitTesting.TestContext
Microsoft.VisualStudio.TestTools.UnitTesting.Assert
Conceptos
Comprobar código utilizando pruebas unitarias