TestFilterContext 类

定义

命名空间:

Microsoft.VisualStudio.TestTools.UnitTesting

程序集:

MSTest.TestFramework.dll

包:

MSTest.TestFramework v4.3.0

Source:

TestFilterContext.cs

元数据 MSTest 的快照针对 ITestFilter 考虑的单个测试公开。

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

继承

Object

TestFilterContext

属性

ExperimentalAttribute NullableAttribute

注解

仅公开没有加载测试类型的可用元数据; ITestFilter 必须能够单独决定使用字符串、类别、特征和优先级。 这是允许筛选器在加载声明类型之前和运行之前[AssemblyInitialize] / [ClassInitialize]删除测试的内容。

属性是可变的（可设置的），因此平台可以通过对象初始值设定项填充它们，因此该类型可以在一段时间内增加新的元数据字段，而不会中断现有 ITestFilter 实现或其单元测试。 MSTest 本身在传递给ITestFilter某个TestFilterContext实例后不会改变;筛选器应同样将接收的实例视为在调用期间有效只读的实例。

每个属性描述测试的单独方面。 平面字符串属性 （FullyQualifiedName， DisplayName） 是方便视图，并且始终填充。 结构化属性（Namespace、、、ClassNameManagedTypeNameManagedMethodName、、、MethodArity）ParameterTypeFullNames可以是null元数据不可用时，通常是通过未显示 ECMA-335 托管名称的代码路径发现的测试。

该类型旨在随着时间的推移进行扩展：无需中断现有 ITestFilter 实现或其单元测试即可添加新属性。 使用者使用对象初始值设定项（例如 new TestFilterContext { FullyQualifiedName = "…" }）;新属性降落时无需更新位置构造函数。

构造函数

名称	说明
TestFilterContext()	元数据 MSTest 的快照针对 ITestFilter 考虑的单个测试公开。

属性

名称	说明
Categories	获取或设置通过 TestCategoryAttribute 方法或其声明类声明的测试类别。 默认为空列表。
ClassName	获取或设置简单类名（不带命名空间），或者 null 当没有可用的托管元数据时。 嵌套类型使用其托管元数据形式（例如 Outer+Inner）;请参阅 ManagedTypeName 完全转义的 ECMA-335 表示形式。
DisplayName	获取或设置测试的显示名称，如向运行程序/IDE 报告。
FullyQualifiedName	获取或设置格式的完全限定的测试名称 Namespace.Class.Method 。
ManagedMethodName	获取或设置 ECMA-335 元数据形式的方法名称，或者 null 当没有可用的托管元数据时。
ManagedTypeName	获取或设置 ECMA-335 元数据形式的声明类型名称，或者 null 当没有可用的托管元数据时。
MethodArity	获取或设置在测试方法上声明的泛型类型参数数，或者 null 当没有可用的托管元数据时。 零表示非泛型方法。
MethodName	获取或设置未限定的测试方法名称（即没有类或命名空间）。
Namespace	获取或设置声明测试类的命名空间，或者 null 当没有可用的托管元数据或类位于全局命名空间中时。
ParameterTypeFullNames	获取或设置测试方法的 ECMA-335 样式完全限定参数类型名称，或者 null 当没有可用的托管元数据时。 空列表指示无参数方法。
Priority	获取或设置 PriorityAttribute 在测试上声明的值，或 null 未声明优先级时。
Source	获取或设置包含此测试的测试程序集文件的路径。
Traits	获取或设置附加到此测试的特征。 多个特征可以共享相同的密钥;因此，使用者不得假定集合的行为类似于字典。 默认为空列表。