TestContext.TestTempDirectory Propriété

public virtual string? TestTempDirectory { get; }

member this.TestTempDirectory : string

Public Overridable ReadOnly Property TestTempDirectory As String

Valeur de propriété

Remarques

Le répertoire est créé sur le premier accès (en différé) et est unique au test en cours d’exécution, y compris chaque cas piloté par les données d’une [DataRow]/[DynamicData] méthode. Étant donné que chaque test (et chaque cas de données) obtient son propre répertoire, les tests peuvent y écrire simultanément sans coordination, même lorsque l’assembly s’exécute en parallèle.

Il s’agit d’un répertoire *par test*. Il retourne null donc lorsqu’il est accessible en dehors d’un test, par exemple à partir de [AssemblyInitialize], [ClassInitialize][ClassCleanup]ou [AssemblyCleanup] — où il n’existe aucun test de propriétaire unique.

Le répertoire est supprimé automatiquement lorsque le test réussit et conservé lors de l’échec du test, de sorte que les artefacts d’un test ayant échoué restent disponibles pour l’inspection. La rétention de tous les répertoires (y compris le passage de tests) peut être forcée pour le débogage via la variable d’environnement MSTEST_TEST_TEMP_DIRECTORY_RETAIN . Le répertoire d’un test réussi est également conservé lorsque le test inscrit un fichier à l’intérieur de celui-ci en tant que pièce jointe AddResultFile(String)par résultat, car l’hôte collecte cette pièce jointe une fois le test terminé.

Contrairement TestRunDirectoryà , , DeploymentDirectoryResultsDirectory, TestRunResultsDirectory, et TestResultsDirectory — qui sont partagés entre les tests pour l’exécution entière — ce répertoire est un espace de travail privé appartenant à un seul test. Utilisez-le pour les fichiers qu’un test doit écrire pendant l’exécution ; utilisez les répertoires de résultats pour les fichiers qui doivent être collectés en tant qu’artefacts d’exécution.

Sur Windows le chemin retourné est suffisamment court pour réserver environ 80 caractères d’espace principal sous la limite classique MAX_PATH (260) pour les fichiers que le test lui-même écrit, de sorte que les chemins relatifs ordinaires créés à l’intérieur de celui-ci ne dépasseront MAX_PATHpas . La fonctionnalité cible la limite de 260 caractères et ne s’appuie pas sur l’opt-in long -path (LongPathsEnabled / le \\?\ préfixe), qui n’est pas garanti d’être activé et n’est souvent pas respecté par les outils externes. Si le répertoire de résultats de l’exécution est trop profond pour conserver cette salle d’attente ou ne peut pas être écrit dans (par exemple, un répertoire de sortie en lecture seule), le répertoire est créé sous le répertoire temporaire système à la place.