Cómo: Habilitar y deshabilitar pruebas

Actualización: noviembre 2007

Una prueba se puede deshabilitar para que no esté disponible temporalmente cuando se vaya a ejecutar un grupo de pruebas que la contenga. Se puede volver a habilitar en cualquier momento. ¿Qué motivos habría para deshabilitar una prueba? Considere las siguientes posibilidades:

• La versión del producto contiene un error que provoca un bloqueo. Este error está en el código que utiliza una de las pruebas. Esta prueba es una entre muchas que se ejecutan en secuencia. Debido al bloqueo que esta prueba desencadena indirectamente, la ejecución de prueba no puede seguir avanzando después de ella en la secuencia. La solución es archivar un error en el código que se bloquea y deshabilitar la prueba hasta que se corrija el error. Así, la secuencia de pruebas podrá avanzar más allá de esa prueba.

• Una prueba específica de una ejecución de prueba revela un error, que el usuario archiva. Para evitar que se encuentre una y otra vez el mismo error conocido cada vez que se ejecute la selección de pruebas, deshabilite la prueba.

  Nota:
  Recuerde rehabilitar una prueba cuando se corrija el error asociado.

Si se ejecuta una lista de pruebas que contiene pruebas deshabilitadas, sólo se ejecutan las pruebas de la lista que están habilitadas, si hay alguna. Si una lista de pruebas no contiene ninguna prueba habilitada, la propia lista se deshabilita.

Utilizar el atributo Ignore con pruebas unitarias

Utilizar el atributo Ignore describe cómo marcar un método de prueba unitaria con el atributo IgnoreAttribute. El uso de este atributo cambia la disponibilidad de la prueba, pero se diferencia en los siguientes aspectos de la otra forma de habilitar y deshabilitar pruebas:

• Como se describe en Deshabilitar pruebas y Habilitar pruebas, puede utilizar el Editor de lista de pruebas para deshabilitar y habilitar pruebas de cualquier tipo. Pero el atributo Ignore sólo se puede aplicar a un método de prueba. Esto significa que el atributo Ignore sólo se puede aplicar a las pruebas unitarias.

• El indicador para habilitar y deshabilitar pruebas está almacenado en el archivo de metadatos de prueba.

• El atributo Ignore para una prueba unitaria se encuentra en el archivo de código fuente de la prueba unitaria, junto con el resto de atributos y código fuente de la prueba. Estos significa que, si se deshabilita una prueba unitaria en el Editor de lista de pruebas y posteriormente se ejecuta la prueba mediante la herramienta de línea de comandos MSTest.exe, la prueba se sigue ejecutando. Pero si se marca una prueba unitaria con el atributo Ignore, se compila el ensamblado y luego se ejecuta la prueba mediante MSTest.exe, la prueba no se ejecuta. Esto se debe a que el atributo Ignore ha pasado a ser parte de la prueba.

Estos dos enfoques se utilizan en escenarios diferentes:

• Atributo Ignore. Es desarrollador que crea código de producción y código de prueba. Está ocupado con una cantidad considerable de cambios y sabe que una de las pruebas unitarias se interrumpirá durante un rato. Por consiguiente, cuando protege la prueba, la marca con el atributo Ignore para indicar que no espera que funcione.

• Deshabilitar y habilitar. Trabaja en un laboratorio de generación y no tiene acceso al código fuente de las pruebas que ejecuta. En este caso, sólo puede utilizar los recursos de habilitar y deshabilitar del Editor de lista de pruebas.

Deshabilitar pruebas

Para deshabilitar pruebas

• Para deshabilitar una prueba, en el Editor de lista de pruebas haga clic con el botón secundario en una prueba habilitada y seleccione Deshabilitar. Para deshabilitar varias pruebas, resalte las pruebas habilitadas que desee deshabilitar, presionando CTRL o MAYÚS mientras hace clic en las filas de las pruebas. Después, haga clic con el botón secundario en las filas seleccionadas y, a continuación, haga clic en Deshabilitar.

  O bien,

  Seleccione la prueba en el Editor de lista de pruebas o la ventana Vista de pruebas y presione F4 para abrir la ventana de propiedades. A continuación, establezca el valor de la propiedad Prueba habilitada en False.

Habilitar pruebas

Para habilitar pruebas

• Para habilitar una prueba, en el Editor de lista de pruebas haga clic con el botón secundario en una prueba deshabilitada y seleccione Habilitar. Para habilitar varias pruebas, resalte las pruebas deshabilitadas que desee habilitar, presionando CTRL o MAYÚS mientras hace clic en las filas de las pruebas. Después, haga clic con el botón secundario en las filas seleccionadas y, a continuación, haga clic en Habilitar.

  O bien

  Seleccione la prueba en el Editor de lista de pruebas o la ventana Vista de pruebas y presione F4 para abrir la ventana de propiedades. A continuación, establezca el valor de la propiedad Prueba habilitada en True.

Utilizar el atributo Ignore

Para utilizar el atributo Ignore

1. Abra la prueba unitaria para editar su código fuente. Para ello, en el Editor de lista de pruebas haga doble clic en la prueba unitaria.

   Se abre el archivo de código fuente que contiene la prueba unitaria.

2. Agregue el atributo IgnoreAttribute a la prueba unitaria.

   Se deshabilita la prueba. En la ventana de propiedades, la propiedad Prueba habilitada se establece automáticamente en False. Para obtener más información acerca del alcance de esta acción, vea la sección anterior "Utilizar el atributo Ignore con pruebas unitarias".

   Para volver a habilitar la prueba, elimine o marque como comentario el atributo Ignore.

Vea también

Tareas

Cómo: Ejecutar las pruebas seleccionadas

Referencia

IgnoreAttribute