TestFilterContext Clase

Definición

Instantánea de los metadatos que MSTest expone a para ITestFilter una sola prueba en consideración.

public sealed class TestFilterContext
[System.Diagnostics.CodeAnalysis.Experimental("MSTESTEXP", UrlFormat="https://aka.ms/mstest/diagnostics#{0}")]
[System.Runtime.CompilerServices.Nullable(0)]
public sealed class TestFilterContext
type TestFilterContext = class
[<System.Diagnostics.CodeAnalysis.Experimental("MSTESTEXP", UrlFormat="https://aka.ms/mstest/diagnostics#{0}")>]
[<System.Runtime.CompilerServices.Nullable(0)>]
type TestFilterContext = class
Public NotInheritable Class TestFilterContext
Herencia
TestFilterContext
Atributos

Comentarios

Solo se exponen los metadatos disponibles sin cargar el tipo de prueba; ITestFilter debe ser capaz de decidir el uso de cadenas, categorías, rasgos y prioridad solo. Esto es lo que permite que el filtro quite las pruebas antes de cargar su tipo declarante y antes de [AssemblyInitialize] / [ClassInitialize] ejecutarse.

Las propiedades son mutables (establecebles) para que la plataforma pueda rellenarlas a través de un inicializador de objeto y, por tanto, el tipo puede aumentar los nuevos campos de metadatos a lo largo del tiempo sin interrumpir las implementaciones existentes ITestFilter o sus pruebas unitarias. MSTest en sí no muta una TestFilterContext vez que se le entrega a ; ITestFilterlos filtros deben tratar igualmente la instancia que reciben como de solo lectura eficaz durante la llamada.

Cada propiedad describe una faceta independiente de la prueba. Las propiedades de cadena plana (FullyQualifiedName, DisplayName) son vistas útiles y siempre se rellenan. Las propiedades estructuradas (Namespace, ClassName, ManagedTypeName, ManagedMethodName, MethodArity, ParameterTypeFullNames) pueden ser null cuando los metadatos no están disponibles, normalmente para las pruebas detectadas a través de rutas de acceso de código que no exponen nombres administrados de ECMA-335.

El tipo está diseñado para extenderse con el tiempo: se pueden agregar nuevas propiedades sin interrumpir las implementaciones existentes ITestFilter o sus pruebas unitarias. Los consumidores construyen instancias mediante un inicializador de objeto (por ejemplo new TestFilterContext { FullyQualifiedName = "…" }, ); no es necesario actualizar ningún constructor posicional cuando se produzcan nuevas propiedades.

Constructores

Nombre Description
TestFilterContext()

Instantánea de los metadatos que MSTest expone a para ITestFilter una sola prueba en consideración.

Propiedades

Nombre Description
Categories

Obtiene o establece las categorías de prueba declaradas a través TestCategoryAttribute del método o su clase declarante. El valor predeterminado es una lista vacía.

ClassName

Obtiene o establece el nombre de clase simple (sin espacio de nombres) o null cuando no hay metadatos administrados disponibles. Los tipos anidados se muestran mediante su formulario de metadatos administrados (por ejemplo Outer+Inner, ); vea ManagedTypeName para obtener la representación ECMA-335 totalmente con escape.

DisplayName

Obtiene o establece el nombre para mostrar de la prueba, tal como se indica al ejecutor o IDE.

FullyQualifiedName

Obtiene o establece el nombre de prueba completo en Namespace.Class.Method el formulario.

ManagedMethodName

Obtiene o establece el nombre del método en el formulario de metadatos ECMA-335 o null cuando no hay metadatos administrados disponibles.

ManagedTypeName

Obtiene o establece el nombre de tipo declarativo en el formulario de metadatos ECMA-335 o null cuando no hay metadatos administrados disponibles.

MethodArity

Obtiene o establece el número de parámetros de tipo genérico declarados en el método de prueba o null cuando no hay metadatos administrados disponibles. Cero indica un método no genérico.

MethodName

Obtiene o establece el nombre del método de prueba no calificado (es decir, sin clase o espacio de nombres).

Namespace

Obtiene o establece el espacio de nombres de la clase de prueba declarando, o null cuando no hay metadatos administrados disponibles o la clase está en el espacio de nombres global.

ParameterTypeFullNames

Obtiene o establece los nombres de tipo de parámetro completo de estilo ECMA-335 del método de prueba o null cuando no hay metadatos administrados disponibles. Una lista vacía indica un método sin parámetros.

Priority

Obtiene o establece el PriorityAttribute valor declarado en la prueba o null cuando no se declaró ninguna prioridad.

Source

Obtiene o establece la ruta de acceso al archivo de ensamblado de prueba que contiene esta prueba.

Traits

Obtiene o establece los rasgos adjuntos a esta prueba. Varios rasgos pueden compartir la misma clave; por lo tanto, los consumidores no deben asumir que la colección se comporta como un diccionario. El valor predeterminado es una lista vacía.

Se aplica a