Was ist das TRX-Dateiformat?
Eine .trx-Datei ist eine XML-basierte Testergebnisdatei, die von der Microsoft Visual Studio-Testinfrastruktur generiert wird. Das Format wurde mit Visual Studio .NET 2003 und dem MSTest-Framework eingeführt und bleibt das Standard-Ausgabeformat sowohl für mstest.exe als auch für den plattformübergreifenden dotnet test-Runner.
Die Datei ist ein einfaches UTF-8-XML-Dokument, dessen Wurzelelement <TestRun> innerhalb eines Microsoft-spezifischen XML-Namespace ist. Im Inneren werden <TestSettings> (Laufkonfiguration), <TestDefinitions> (Testmethodennamen und Assemblies), <Results> mit einem <UnitTestResult> pro Testfall (Ergebnis, Dauer, Zeitstempel, Fehlermeldungen, Stack-Traces) und eine <ResultSummary> mit aggregierten Zahlen für Bestanden/Fehlgeschlagen/Nicht eindeutig aufgezeichnet. Das Schema ist in vstst.xsd definiert, das mit Visual Studio im Verzeichnis Common7/IDE/ ausgeliefert wird.
.trx-Dateien werden nicht automatisch erstellt - sie erfordern eine explizite Logger-Konfiguration. Um eine zu generieren, übergeben Sie --logger trx an dotnet test oder geben Sie das entsprechende Flag für mstest.exe an. Azure DevOps und TFS parsen .trx-Dateien nativ über den Task „Publish Test Results“, wodurch Pass/Fail-Berichte in der Pipeline-Benutzeroberfläche gerendert werden.
Da .trx ein XML-Format ist, kann jeder Texteditor es öffnen. Visual Studio Code mit dem C# Dev Kit bietet eine reichhaltigere Visualisierung. Das Format ist Microsoft-zentriert; plattformübergreifende CI-Systeme wie GitHub Actions oder Jenkins bevorzugen in der Regel JUnit-XML-Testberichte. Seit Visual Studio 2022 und dem .NET SDK wird die .trx-Generierung auch unter Linux und macOS über dotnet test unterstützt.
Sicherheit
RISIKO: LOWTRX-Dateien sind einfaches UTF-8-XML - sie enthalten Testergebnisse, keinen ausführbaren Code. Das Öffnen in Visual Studio, VS Code oder einem Texteditor ist völlig sicher. Verwenden Sie keine „TRX-Viewer“-Downloads von Drittanbietern unbekannter Herkunft; diese sind unnötig und können Adware enthalten. Visual Studio Community (kostenlos) oder VS Code (kostenlos, Open Source) sind sichere und ausreichende Programme zum Öffnen.
Formatdetails
kurz gefasstProgramme zum Öffnen von TRX-Dateien
Technische Details
technische Spezifikation| Dateityp | UTF-8 XML-Dokument (Klartext) |
| XML-Wurzelelement | `<TestRun>` im Microsoft vstst XML-Namespace |
| Schemadatei | `vstst.xsd` - wird mit Visual Studio in `Common7/IDE/` ausgeliefert |
| Befehl zum Generieren | `dotnet test --logger trx` oder `mstest.exe /logger:trx` |
| Typische Dateigröße | 5 KB - 10 MB (skaliert mit der Anzahl der Tests und der Ausführlichkeit der Stack-Traces) |
| Datensatz-Element pro Test | `<UnitTestResult>` - speichert Ergebnis, Dauer, Zeitstempel, Fehlermeldung und Stack-Trace |
| Zusammenfassungs-Element | `<ResultSummary>` - aggregierte Anzahl für Bestanden, Fehlgeschlagen, Nicht eindeutig und Gesamt |
| Ergebnis-Container | `<Results>`-Element, das alle `<UnitTestResult>`-Kindelemente enthält |
| Nicht standardmäßig generiert | Erfordert das explizite Flag `--logger trx`; wird bei einem einfachen `dotnet test`-Lauf nicht erstellt |
| Plattformunterstützung | Windows, Linux, macOS (über plattformübergreifendes .NET SDK) |
| Azure DevOps-Integration | Wird nativ vom Pipeline-Task „Publish Test Results“ geparst |
| Plattformübergreifendes CI-Format | JUnit XML wird von Nicht-Microsoft-CI-Systemen bevorzugt (GitHub Actions, Jenkins, GitLab CI) |
| Variationen im Generatorformat | TRX von `mstest.exe` unterscheidet sich geringfügig von TRX, das durch `dotnet test` erzeugt wurde; beide sind gültig |
| Kompression | Keine - einfaches XML; große Test-Suites mit Stack-Traces können Dateien im zweistelligen MB-Bereich erzeugen |
| Veröffentlicht | 2003 (Visual Studio .NET 2003, MSTest framework) |
| Neueste Version | vstst.xsd schema current as of Visual Studio 2022; vstest also generates TRX in .NET SDK 2026 |
| Spezifikation | learn.microsoft.com |
TRX-Konvertierungen
Community Q&A
von Nutzern gefragtNoch keine Fragen - stellen Sie die erste Frage zu TRX-Dateien.