Blocage et vidages de blocage

Ces fonctionnalités nécessitent l’installation de packages NuGet supplémentaires, comme décrit dans chaque section.

Conseil / Astuce

Lors de l’utilisation de Microsoft.Testing.Platform.MSBuild (inclus transitivement par MSTest, NUnit et xUnit Runners), ces extensions sont enregistrées automatiquement lorsque vous installez leurs packages NuGet, sans modification du code nécessaire. L’inscription manuelle spécifiée dans cet article n’est requise que si vous avez désactivé le point d’entrée généré automatiquement en définissant <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Vidage sur incident

Cette extension vous permet de créer un fichier de vidage sur incident en cas de blocage du processus. Cette extension nécessite le package NuGet Microsoft.Testing.Extensions.CrashDump .

Inscription manuelle

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHostControllers.AddCrashDumpProvider();

Options

Choix	Descriptif
--crashdump	Génère un fichier de vidage lorsque le processus hôte de test se bloque. Prise en charge dans .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Spécifie le nom du fichier de vidage.
--crashdump-type	Spécifie le type de vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Défini par défaut comme Full. Pour plus d’informations, consultez Types de mini-images mémoire.

Avertissement

L’extension n’est pas compatible avec .NET Framework et est ignorée en mode silencieux. Pour la prise en charge de .NET Framework, vous activez le débogage post-mortem avec Sysinternals ProcDump. Pour plus d’informations, consultez Activation du débogage post-mortem : Windows Sysinternals ProcDump. La solution de débogage postmortem collecte également des informations sur les incidents de processus pour .NET afin de pouvoir éviter l’utilisation de l’extension si vous ciblez à la fois les applications de test .NET et .NET Framework.

Vidage sur blocage

Cette extension vous permet de créer un fichier de vidage après un délai d’attente donné. Cette extension nécessite le package NuGet Microsoft.Testing.Extensions.HangDump .

Inscription manuelle

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHostControllers.AddHangDumpProvider();

Options

Choix	Descriptif
--hangdump	Génère un fichier de vidage au cas où le processus hôte de test se bloque.
-⁠-hangdump-filename	Spécifie le nom du fichier de vidage.
--hangdump-timeout	Spécifie la durée d’absence d’activité après laquelle le vidage est généré. La valeur du délai d’expiration est spécifiée dans l’un des formats suivants : 1.5h, 1.5hour, 1.5hours 90m, 90min, 90minute, 90minutes 5400s, 5400sec5400second, 5400seconds. La valeur par défaut est 30m (30 minutes).
--hangdump-type	Spécifie le type de vidage. Les valeurs valides sont Mini, , HeapTriage, Full. Défini par défaut comme Full. Pour plus d’informations, consultez Types de mini-images mémoire.