Tutorial: Uso de una condición de prueba personalizada para comprobar el resultado de un procedimiento almacenado
En el tutorial de esta extensión de característica, creará una condición de prueba y comprobará su funcionalidad creando una prueba unitaria de SQL Server. El proceso incluye la creación de un proyecto de biblioteca de clases para la condición de prueba, así como su firma y su instalación. Si ya tiene una condición de prueba que desea actualizar, consulte Cómo: Actualizar una condición de prueba personalizada de Visual Studio 2010 desde una versión anterior a SQL Server Data Tools.
En este tutorial se muestran las tareas siguientes:
Cómo crear una condición de prueba.
Cómo firmar el ensamblado con un nombre seguro.
Cómo agregar las referencias necesarias al proyecto.
Cómo compilar una condición de prueba.
Cómo instalar la nueva condición de prueba.
Cómo probar la nueva condición de prueba.
Para completar este tutorial, debe tener Visual Studio 2010 o Visual Studio 2012 con la versión más reciente de SQL Server Data Tools. Para más información, consulte Instalar SQL Server Data Tools.
Crear una condición de prueba personalizada
En primer lugar, creará una biblioteca de clases.
En el menú Archivo, haga clic en Nuevo y, a continuación, haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, en Tipos de proyecto, haga clic en Visual C#.
En Plantillas, seleccione Biblioteca de clases.
En el cuadro de texto Nombre, escriba ColumnCountCondition y haga clic en Aceptar.
Después, firme el proyecto.
En el menú Proyecto, haga clic en Propiedades de ColumnCountCondition.
En la pestaña Firma, active la casilla Firmar el ensamblado.
En el cuadro Elegir un archivo de clave de nombre seguro, haga clic en <Nuevo…>.
Aparecerá el cuadro de diálogo Crear clave de nombre seguro.
En el cuadro Nombre del archivo de clave, escriba SampleKey.
Escriba y confirme una contraseña y, a continuación, haga clic en Aceptar. Al compilar su solución, el archivo de clave se usa para firmar el ensamblado.
En el menú Archivo , haga clic en Guardar todo.
En el menú Compilar, haga clic en Compilar solución.
Después, agregará las referencias necesarias al proyecto.
En el Explorador de soluciones, seleccione el proyecto ColumnCountCondition.
En el menú Proyecto, haga clic en Agregar referencia para mostrar el cuadro de diálogo Agregar referencia.
Seleccione la pestaña .NET.
En la columna Nombre de componente, busque y seleccione el componente System.ComponentModel.Composition. Haga clic en Aceptar después de seleccionar el componente.
Agregue las referencias de ensamblado necesarias. Haga clic con el botón derecho en el nodo del proyecto y, a continuación, haga clic en Agregar referencia. Haz clic en Examinar y ve a la carpeta
C:\Program Files (x86)\Microsoft SQL Server\110\DAC\Bin. Seleccione Microsoft.Data.Tools.Schema.Sql.dll, haga clic en Agregar y, a continuación, haga clic en Aceptar.En el menú Proyecto, haga clic en Descargar el proyecto.
Haga clic con el botón derecho en el proyecto en el Explorador de soluciones y elija Editar <nombreDeProyecto>.csproj.
Agregue la instrucción Import siguiente después de la importación de Microsoft.CSharp.targets:
<Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v10.0\SSDT\Microsoft.Data.Tools.Schema.Sql.UnitTesting.targets" Condition="'$(VisualStudioVersion)' == ''" /> <Import Project="$(MSBuildExtensionsPath32)\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.Sql.UnitTesting.targets" Condition="'$(VisualStudioVersion)' != ''" />Guarde el archivo y ciérrelo. Haga clic con el botón derecho en el proyecto en el Explorador de soluciones y elija Volver a cargar el proyecto.
Las referencias necesarias se mostrarán bajo el nodo Referencias del proyecto en el Explorador de soluciones.
Crear la clase ResultSetColumnCountCondition
Ahora, cambiará el nombre de Class1 a ResultSetColumnCountCondition y lo derivará de testcondition. La clase ResultSetColumnCountCondition es una condición de prueba simple que comprueba el número de columnas devueltas en el ResultSet. Puede emplear esta condición para asegurarse de que el contrato de un procedimiento almacenado es correcto.
En el Explorador de soluciones, haga clic con el botón derecho en Class1.cs, haga clic en Cambiar nombre y escriba ResultSetColumnCountCondition.cs.
Haga clic en Sí para confirmar el cambio de nombre de todas las referencias a Class1.
Abra el archivo ResultSetColumnCountCondition.cs y agregue las siguientes instrucciones using al archivo:
using System; using System.ComponentModel; using System.Data; using System.Data.Common; using Microsoft.Data.Tools.Schema.Sql.UnitTesting; using Microsoft.Data.Tools.Schema.Sql.UnitTesting.Conditions; namespace ColumnCountCondition { public class ResultSetColumnCountConditionDerive la clase de testcondition:
public class ResultSetColumnCountCondition : TestConditionAgregue ExportTestConditionAttribute. Consulte Cómo: Crear condiciones de prueba para el Diseñador de pruebas unitarias de SQL Server para más información sobre UnitTesting.Conditions.ExportTestConditionAttribute.
[ExportTestCondition("ResultSet Column Count", typeof(ResultSetColumnCountCondition))] public class ResultSetColumnCountCondition : TestConditionCrear las variables miembro y el constructor:
private int _resultSet; private int _count; private int _batch; public ResultSetColumnCountCondition() { _resultSet = 1; _count = 0; _batch = 1; }Invalide el método Assert. El método incluye argumentos para IDbConnection, que representa la conexión con la base de datos, y SqlExecutionResult. El método usa DataSchemaException para el control de errores:
//method you need to override //to perform the condition verification public override void Assert(DbConnection validationConnection, SqlExecutionResult[] results) { //call base for parameter validation base.Assert(validationConnection, results); //verify batch exists if (results.Length < _batch) throw new DataException(String.Format("Batch {0} does not exist", _batch)); SqlExecutionResult result = results[_batch - 1]; //verify resultset exists if (result.DataSet.Tables.Count < ResultSet) throw new DataException(String.Format("ResultSet {0} does not exist", ResultSet)); DataTable table = result.DataSet.Tables[ResultSet - 1]; //actual condition verification //verify resultset column count matches expected if (table.Columns.Count != Count) throw new DataException(String.Format( "ResultSet {0}: {1} columns did not match the {2} columns expected", ResultSet, table.Columns.Count, Count)); } Add the following method, which overrides the ToString method: C# //this method is called to provide the string shown in the //test conditions panel grid describing what the condition tests public override string ToString() { return String.Format( "Condition fails if ResultSet {0} does not contain {1} columns", ResultSet, Count); }Agregue las siguientes propiedades de condición de prueba mediante los atributos CategoryAttribute, DisplayNameAttribute y DescriptionAttribute:
//below are the test condition properties //that are exposed to the user in the property browser #region Properties //property specifying the resultset for which //you want to check the column count [Category("Test Condition")] [DisplayName("ResultSet")] [Description("ResultSet Number")] public int ResultSet { get { return _resultSet; } set { //basic validation if (value < 1) throw new ArgumentException("ResultSet cannot be less than 1"); _resultSet = value; } } //property specifying //expected column count [Category("Test Condition")] [DisplayName("Count")] [Description("Column Count")] public int Count { get { return _count; } set { //basic validation if (value < 0) throw new ArgumentException("Count cannot be less than 0"); _count = value; } } #endregion
El código final es el siguiente:
using System;
using System.ComponentModel;
using System.Data;
using System.Data.Common;
using Microsoft.Data.Tools.Schema.Sql.UnitTesting;
using Microsoft.Data.Tools.Schema.Sql.UnitTesting.Conditions;
namespace ColumnCountCondition
{
[ExportTestCondition("ResultSet Column Count", typeof(ResultSetColumnCountCondition))]
public class ResultSetColumnCountCondition : TestCondition
{
private int _resultSet;
private int _count;
private int _batch;
public ResultSetColumnCountCondition()
{
_resultSet = 1;
_count = 0;
_batch = 1;
}
//method you need to override
//to perform the condition verification
public override void Assert(DbConnection validationConnection, SqlExecutionResult[] results)
{
//call base for parameter validation
base.Assert(validationConnection, results);
//verify batch exists
if (results.Length < _batch)
throw new DataException(String.Format("Batch {0} does not exist", _batch));
SqlExecutionResult result = results[_batch - 1];
//verify resultset exists
if (result.DataSet.Tables.Count < ResultSet)
throw new DataException(String.Format("ResultSet {0} does not exist", ResultSet));
DataTable table = result.DataSet.Tables[ResultSet - 1];
//actual condition verification
//verify resultset column count matches expected
if (table.Columns.Count != Count)
throw new DataException(String.Format(
"ResultSet {0}: {1} columns did not match the {2} columns expected",
ResultSet, table.Columns.Count, Count));
}
//this method is called to provide the string shown in the
//test conditions panel grid describing what the condition tests
public override string ToString()
{
return String.Format(
"Condition fails if ResultSet {0} does not contain {1} columns",
ResultSet, Count);
}
//below are the test condition properties
//that are exposed to the user in the property browser
#region Properties
//property specifying the resultset for which
//you want to check the column count
[Category("Test Condition")]
[DisplayName("ResultSet")]
[Description("ResultSet Number")]
public int ResultSet
{
get { return _resultSet; }
set
{
//basic validation
if (value < 1)
throw new ArgumentException("ResultSet cannot be less than 1");
_resultSet = value;
}
}
//property specifying
//expected column count
[Category("Test Condition")]
[DisplayName("Count")]
[Description("Column Count")]
public int Count
{
get { return _count; }
set
{
//basic validation
if (value < 0)
throw new ArgumentException("Count cannot be less than 0");
_count = value;
}
}
#endregion
}
}
Después, compilaremos el proyecto.
Compilar el proyecto e instalar la condición de prueba
En el menú Compilar, haga clic en Compilar solución.
Después, copiará la información del ensamblado en el directorio Extensions. Cuando Visual Studio se inicie, identificará cualquier extensión del directorio %Program Files%\Microsoft Visual Studio <versión>\Common7\IDE\Extensions\Microsoft\SQLDB\TestConditions y sus subdirectorios, y hará que estén disponibles para su uso:
Copie el archivo de ensamblado ColumnCountCondition.dll desde el directorio de resultados al directorio %Program Files%\Microsoft Visual Studio <versión>\Common7\IDE\Extensions\Microsoft\SQLDB\TestConditions.
De manera predeterminada, la ruta de acceso del archivo .dll compilado es YourSolutionPath\YourProjectPath\bin\Debug o YourSolutionPath\YourProjectPath\bin\Release.
Después, iniciará una nueva sesión de Visual Studio y creará un proyecto de base de datos. Para iniciar una nueva sesión de Visual Studio y crear un proyecto de base de datos:
Inicie una segunda sesión de Visual Studio.
En el menú Archivo, haga clic en Nuevo y, a continuación, haga clic en Proyecto.
En el cuadro de diálogo Nuevo proyecto, en la lista de plantillas instaladas, seleccione el nodo SQL Server.
En el panel de detalles, haga clic en Proyecto de base de datos de SQL Server.
En el cuadro de texto Nombre, escriba SampleConditionDB y haga clic en Aceptar.
Después, necesitamos crear una prueba unitaria. Para crear una prueba unitaria de SQL Server en una nueva clase de prueba:
En el menú Prueba, haga clic en Nueva prueba para mostrar el cuadro de diálogo Agregar nueva prueba.
También puede abrir el Explorador de soluciones, hacer clic con el botón derecho en un proyecto de prueba, seleccionar Agregar y, a continuación, hacer clic en Nueva prueba.
En la lista de plantillas, haga clic en Prueba unitaria de SQL Server.
En Nombre de la prueba, escriba SampleUnitTest.
En Agregar a proyecto de prueba, haga clic en Crear un nuevo proyecto de prueba de Visual C#. Después, haga clic en Aceptar para mostrar el cuadro de diálogo Nuevo proyecto de prueba.
Escriba SampleUnitTest como nombre del proyecto.
Haga clic en Cancelar para crear la prueba unitaria sin configurar proyecto de prueba para que use una conexión de base de datos. Aparecerá la prueba en blanco en el Diseñador de pruebas unitarias de SQL Server. Se agregará un archivo de código fuente de Visual C# al proyecto de prueba.
Para obtener más información acerca de cómo crear y configurar pruebas unitarias de base de datos con conexiones de base de datos, vea Cómo: Crear una prueba unitaria de SQL Server vacía.
Haga clic en Haga clic aquí para crear para terminar de crear la prueba unitaria. Verá que la nueva condición de prueba aparece en el proyecto de SQL Server.
Nota
Para usar la condición de prueba personalizada con proyectos de prueba unitaria existentes, se debe crear al menos una nueva clase de prueba unitaria de SQL Server. La referencia necesaria al ensamblado de condición de prueba se agregará al proyecto de prueba durante la creación de la clase de prueba.
Para ver la nueva condición de prueba:
En el Diseñador de pruebas unitarias de SQL Server, bajo Condiciones de prueba, en la columna Nombre, haga clic en la prueba inconclusiveCondition1.
Haga clic en el botón Eliminar condición de prueba de la barra de herramientas para borrar la prueba inconclusiveCondition1.
Haga clic en el desplegable Condiciones de prueba y seleccione Número de columnas de ResultSet.
Haga clic en el botón Agregar condición de prueba de la barra de herramientas para agregar la condición de prueba personalizada.
En la ventana Propiedades, configure las propiedades Count, Enabled y ResultSet.
Para más información, vea: Cómo: Incorporar condiciones de prueba a pruebas unitarias de SQL Server.
Consulte también
Condiciones de prueba personalizadas para pruebas unitarias de SQL Server