TestFilterContext Klasse

Definition

Namespace:
Microsoft.VisualStudio.TestTools.UnitTesting
Assembly:
MSTest.TestFramework.dll
Paket:
MSTest.TestFramework v4.3.0
Quelle:
TestFilterContext.cs

Momentaufnahme der Metadaten MSTest stellt einen ITestFilter einzelnen Test zur Verfügung.

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
Vererbung
Object
TestFilterContext
Attribute
ExperimentalAttribute NullableAttribute

Hinweise

Nur Metadaten, die verfügbar sind, ohne den Testtyp zu laden, werden verfügbar gemacht. ITestFilter muss allein die Verwendung von Zeichenfolgen, Kategorien, Merkmalen und Priorität entscheiden können. Dies ermöglicht es dem Filter, Tests abzulegen , bevor der deklarierende Typ geladen und vor der [AssemblyInitialize] / [ClassInitialize] Ausführung ausgeführt wird.

Eigenschaften sind änderbar (settable), sodass die Plattform sie über einen Objektinitialisierer auffüllen kann und der Typ neue Metadatenfelder im Laufe der Zeit vergrößern kann, ohne vorhandene ITestFilter Implementierungen oder deren Komponententests zu unterbrechen. MSTest selbst wird nicht stummgeschaltet, TestFilterContext nachdem sie an einen ITestFilter; Filter sollten die Instanz, die sie erhalten, ebenfalls als effektiv schreibgeschützt für die Dauer des Anrufs behandeln.

Jede Eigenschaft beschreibt ein separates Facet des Tests. Die flachen Zeichenfolgeneigenschaften (FullyQualifiedName, DisplayName) sind Komfortansichten und werden immer aufgefüllt. Die strukturierten Eigenschaften (Namespace, , , ManagedMethodNameManagedTypeName, MethodArity, ParameterTypeFullNames) können seinnull, ClassNamewenn die Metadaten nicht verfügbar sind – in der Regel für Tests, die über Codepfade ermittelt werden, die keine verwalteten ECMA-335-Namen enthalten.

Der Typ soll im Laufe der Zeit erweitert werden: Neue Eigenschaften können hinzugefügt werden, ohne vorhandene ITestFilter Implementierungen oder deren Komponententests zu unterbrechen. Consumer erstellen Instanzen mit einem Objektinitialisierer (z. B. new TestFilterContext { FullyQualifiedName = "…" }); es muss kein Positionskonstruktor aktualisiert werden, wenn neue Eigenschaften landen.

Konstruktoren

Name Beschreibung
TestFilterContext()

Momentaufnahme der Metadaten MSTest stellt einen ITestFilter einzelnen Test zur Verfügung.

Eigenschaften

Name Beschreibung
Categories

Dient zum Abrufen oder Festlegen der Testkategorien, die über TestCategoryAttribute die Methode oder die deklarierende Klasse deklariert werden. Standardmäßig wird eine leere Liste verwendet.
ClassName

Dient zum Abrufen oder Festlegen des einfachen Klassennamens (ohne Namespace) oder null wenn keine verwalteten Metadaten verfügbar sind. Geschachtelte Typen werden mithilfe ihres verwalteten Metadatenformulars angezeigt (z. B. Outer+Inner); siehe ManagedTypeName die vollständig escaped ECMA-335-Darstellung.
DisplayName

Dient zum Abrufen oder Festlegen des Anzeigenamens des Tests, wie an den Runner /IDE gemeldet.
FullyQualifiedName

Ruft den vollqualifizierten Testnamen im Namespace.Class.Method Formular ab oder legt diesen fest.
ManagedMethodName

Dient zum Abrufen oder Festlegen des Methodennamens im ECMA-335-Metadatenformular oder null wenn keine verwalteten Metadaten verfügbar sind.
ManagedTypeName

Dient zum Abrufen oder Festlegen des deklarierenden Typnamens im ECMA-335-Metadatenformular oder null wenn keine verwalteten Metadaten verfügbar sind.
MethodArity

Ruft die Anzahl der generischen Typparameter ab, die für die Testmethode deklariert wurden, oder legt sie fest, wenn null keine verwalteten Metadaten verfügbar sind. Null gibt eine nicht generische Methode an.
MethodName

Dient zum Abrufen oder Festlegen des nicht qualifizierten Testmethodennamens (d. h. ohne Klasse oder Namespace).
Namespace

Ruft den Namespace der deklarierenden Testklasse ab oder legt den Namespace fest, oder null wenn keine verwalteten Metadaten verfügbar sind oder sich die Klasse im globalen Namespace befindet.
ParameterTypeFullNames

Dient zum Abrufen oder Festlegen der vollqualifizierten ECMA-335-Parametertypnamen der Testmethode oder null wenn keine verwalteten Metadaten verfügbar sind. Eine leere Liste gibt eine parameterlose Methode an.
Priority

Dient zum Abrufen oder Festlegen des PriorityAttribute für den Test deklarierten Werts oder null wenn keine Priorität deklariert wurde.
Source

Dient zum Abrufen oder Festlegen des Pfads zur Testassemblydatei, die diesen Test enthält.
Traits

Ruft die Eigenschaften ab, die an diesen Test angefügt sind, oder legt diese fest. Mehrere Merkmale können denselben Schlüssel gemeinsam nutzen; Verbraucher dürfen daher nicht davon ausgehen, dass sich die Sammlung wie ein Wörterbuch verhält. Standardmäßig wird eine leere Liste verwendet.

Gilt für: