Test Konsolenanwendung C# (Wie es für Entwickler funktioniert)

Das Testen spielt eine zentrale Rolle in der Softwareentwicklung und ist ein entscheidendes Element zur Gewährleistung der Qualität von Anwendungen. Unter der Fülle der verfügbaren Frameworks sticht .NET als eine weit verbreitete Wahl für die Erstellung von Windows-basierten Anwendungen hervor. Dieser Artikel befasst sich mit den Feinheiten von .NET TestConsole, einem Tool, das speziell für das Testen von .NET-Anwendungen entwickelt wurde.

Im Laufe dieser Untersuchung werden wir ein umfassendes Codebeispiel schreiben, das die praktische Implementierung von .NET TestConsole veranschaulicht. Darüber hinaus werden wir IronPDF vorstellen, eine beispielhafte C# PDF-Bibliothek, die nahtlos in die .NET TestConsole integriert ist. Diese Bibliothek ist von unschätzbarem Wert und ermöglicht Entwicklern den mühelosen Zugriff auf und die Erzeugung von PDFs innerhalb von .NETTestConsole-Umgebung. Begleiten Sie uns auf dieser Reise und entdecken Sie die Funktionalitäten und Möglichkeiten, die sich aus der Synergie von .NET TestConsole undIronPDF's C# PDF-Funktionalität.

1. Einführung: TestConsole

TestConsole ist eine vielseitige Testbibliothek, die einen besonderen Ansatz für Unit-Tests in der Programmiersprache C# bietet. Herkömmliche Methoden für Unit-Tests sind bei großen Datensätzen und komplexen Aussagen oft problematisch, da sie zu Schwierigkeiten bei der Ermittlung von Unterschieden zwischen erwarteten und tatsächlichen Ergebnissen führen. Als Antwort darauf bietet TestConsole einen neuartigen Arbeitsablauf, der vom konventionellen, auf Vorhersagen basierenden Ansatz zu einem Seite-an-Seite-Vergleich der formatierten Ausgabe mit einer bestimmten "genehmigten" Standardausgabeversion übergeht.

In dieser Bibliothek, insbesondere in der TestConsole, erweitert die '.Core'-Variante die vom ursprünglichen TestConsole-Projekt geerbten Formatierungsmöglichkeiten und enthält wesentliche Funktionen zur Testfreigabe in Szenarien, in denen die Testergebnisse von den Erwartungen abweichen. TestConsole.Core integriert sich nahtlos in den Build-Server, um einen Testfehler auszulösen. Auf dem Entwicklungs-PC bietet es standardmäßig die Möglichkeit, installierte Dateivergleichsprogramme zur Visualisierung von Unterschieden zu verwenden. Dieser Ansatz vereinfacht insbesondere den Genehmigungsprozess, da die Entwickler die genehmigte Version manuell aktualisieren können, wenn Abweichungen zu erwarten sind.

1.1. Warum TestConsole verwenden?

TestConsole.Core lehnt sich an ApprovalTests an, unterscheidet sich aber durch die Unterstützung für das Schreiben von Testsuiten sowohl für das komplette Framework als auch für .NET Core. Die Bibliothek befasst sich mit dem Bedarf an Tests in verschiedenen Umgebungen, die, wie bei ApprovalTests zum Zeitpunkt der Veröffentlichung, in erster Linie auf vollständige Framework-Szenarien ausgerichtet sind. Die Syntax in TestConsole.Core weist zwar Ähnlichkeiten mit ApprovalTests auf, bietet jedoch Unterschiede, insbesondere hinsichtlich der Auswahl von Dateivergleichswerkzeugen und der direkten Genehmigung von Inhalten.

TestConsole.Core wurde entwickelt, um das Testen von .NET Core-Anwendungscode zu erleichtern, und entstand aus der Notwendigkeit, die Lücke zu schließen, die durch die fehlende Unterstützung von .NET-Standard- und .NET Core-Anwendungen in ApprovalTests entstanden ist. Die Testgenehmigungsfunktionen von TestConsole.Core sind darauf ausgerichtet, das effektive Testen großer Datensätze zu ermöglichen. Sie passen sich an Daten an, die mit dem Test Console Output-Objekt formatiert wurden, und erweitern ihre Funktionalität, um beliebige Klartexteingaben zu verarbeiten, und bieten so eine umfassende Lösung für Unit-Tests in C#.

1.2. TestConsole C# installieren

Die Testkonsole kann über das NuGet-Paketmanager-Formular in Visual Studio installiert werden, oder durch Ausführen des folgenden Befehls in der NuGet-Paketmanager-Konsole.

Install-Package TestConsole -Version 2.6.0

Oder laden Sie direkt von derTestConsole-Verteilung auf NuGet.

2. Code-Beispiel für TestConsole

In diesem Abschnitt wird gezeigt, wie Sie Konsolenausgaben in Berichte umwandeln können. Der folgende Quellcode verwendet eine Testkonsole, um Enumerable-Objekte in eine gut formatierte Berichtstabelle zu konvertieren.

using TestConsoleLib;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
Console.WriteLine(report);

using TestConsoleLib;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
Console.WriteLine(report);

Imports TestConsoleLib
Private output = New Output()
Private data = Enumerable.Range(0, 10).Select(Function(i) New With {
	Key .Value = i,
	Key .Squared = i * i,
	Key .String = New String("I"c, i)
})
output.FormatTable(data)
Dim report As String = output.Report
Console.WriteLine(report)

Dieses C#-Codefragment verwendet die TestConsoleLib-Bibliothek, um ein einfaches Beispiel für die Formatierung und Berichterstellung von Tabellendaten mit der TestConsole-Ausgabeklasse zu demonstrieren und auszuführen. Zunächst wird eine Instanz der Klasse Output mit dem Namen 'output' erzeugt Anschließend wird eine Sammlung von 10 Elementen erzeugt, die anonyme Objekte mit Eigenschaften enthält, die einen Integer-Wert, sein Quadrat und eine Zeichenkette mit "I" darstellen, deren Länge dem Integer-Wert entspricht.

Die output.FormatTable() methode wird dann aufgerufen, um die Daten in eine Tabelle zu formatieren. Das formatierte Ergebnis wird in der String-Variablen 'report' gespeichert, die schließlich mit Console.WriteLine auf der Konsole ausgegeben wird(). Dies veranschaulicht die Fähigkeit von TestConsole, tabellarische Daten einfach zu formatieren und darzustellen, um die Lesbarkeit bei Unit-Tests oder Debugging-Szenarien zu verbessern.

2.1. Ausgabe

3. IronPDF

IronPDFs offizielle Website bietet eine umfassende Plattform für eine robuste C# PDF-Bibliothek, die die Arbeit mit PDF-Dokumenten in .NET-Anwendungen vereinfacht und verbessert. IronPDF bietet einen umfassenden Funktionsumfang, der es Entwicklern ermöglicht, in ihren C#-Projekten mühelos Inhalte aus PDF-Dateien zu erstellen, zu bearbeiten und zu extrahieren. IronPDF ist auf Flexibilität und Benutzerfreundlichkeit ausgerichtet und unterstützt eine breite Palette von Funktionen, einschließlich der Erstellung von PDFs aus HTML, Bildern oder vorhandenen Dokumenten sowie der Einbindung dynamischer Inhalte wie Diagramme und Tabellen.

Seine Möglichkeiten erstrecken sich auf das Zusammenführen, Aufteilen und Manipulieren von PDF-Seiten sowie auf Funktionen wie die Extraktion von Text und Bildern. Ob für Berichte, Dokumentationen oder andere PDF-bezogene Aufgaben, IronPDF zeichnet sich als zuverlässige und vielseitige Lösung aus, die die Integration von PDF-Funktionen in C#-Anwendungen mit minimalem Aufwand vereinfacht.

3.1. Erstellen von PDF-Dateien der Berichte der Testkonsole

In diesem Abschnitt wird erläutert, wie Sie die Ausgabe von TestConsole-Berichten konvertieren können.

Erste Schritte mit IronPDF

Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:

Kostenloser Start

IronPDF-Bibliothek installieren

Installation mit NuGet-Paketmanager

Gehen Sie folgendermaßen vor, um IronPDF mit Hilfe des NuGet-Paketmanagers in Ihr Konsolenprojekt zu integrieren:

1. Öffnen Sie Visual Studio und klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt.

2. Wählen Sie "NuGet-Pakete verwalten..." aus dem Kontextmenü.

3. Gehen Sie auf die Registerkarte Durchsuchen und suchen Sie nach IronPDF.

4. Wählen Sie die IronPDF-Bibliothek aus den Suchergebnissen aus und klicken Sie auf die Schaltfläche Installieren.

5. Akzeptieren Sie die Aufforderung zu einer Lizenzvereinbarung.

   Wenn Sie IronPDF über die Paketmanager-Konsole in Ihr Projekt einbinden möchten, führen Sie den folgenden Befehl in der Paketmanager-Konsole aus:

Install-Package IronPdf

Es wird IronPDF in Ihr Projekt holen und installieren.

Installation über die NuGet-Website

Einen detaillierten Überblick über IronPDF, einschließlich seiner Funktionen, Kompatibilität und zusätzlicher Download-Optionen, finden Sie auf der IronPDF-Seite auf der NuGet-Website unter https://www.nuget.org/packages/IronPdf.

Installation über DLL

Alternativ können Sie IronPDF auch direkt in Ihr Projekt einbinden, indem Sie seine DLL-Datei verwenden. Laden Sie die ZIP-Datei, die die DLL enthält, von dieser Seite herunterIronPDF ZIP-Paket. Entpacken Sie die Datei, und binden Sie die DLL in Ihr Projekt ein.

Nach der Installation werden wir den obigen Beispielbericht neu erstellen, aber dieses Mal werden wir ihn nicht in die Konsole schreiben, sondern einen PDF-Bericht daraus erstellen.

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
var htmlContent = $"<pre>{report}</pre>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("test.pdf");

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
var output = new Output();
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });
output.FormatTable(data);
string report = output.Report;
var htmlContent = $"<pre>{report}</pre>";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("test.pdf");

Imports TestConsole.OutputFormatting
Imports TestConsoleLib
Imports IronPdf
Private output = New Output()
Private data = Enumerable.Range(0, 10).Select(Function(i) New With {
	Key .Value = i,
	Key .Squared = i * i,
	Key .String = New String("I"c, i)
})
output.FormatTable(data)
Dim report As String = output.Report
Dim htmlContent = $"<pre>{report}</pre>"
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("test.pdf")

Dieses C# Code Snippet zeigt die Integration von TestConsoleLib und IronPDF, um ein PDF-Dokument mit einer formatierten Datentabelle zu erzeugen. Zunächst wird eine Instanz der Klasse Output der TestConsoleLib erstellt und eine Tabelle mit Daten formatiert, die aus einem Bereich von Ganzzahlen erzeugt wurden. Die formatierte Ausgabe wird in der String-Variablen "report" gespeichert, die dann in HTML-Pre-Tags eingeschlossen wird, um die Formatierung zu erhalten.

Anschließend nutzt der Code den ChromePdfRenderer von IronPDF, um den HTML-Inhalt als PDF-Dokument zu rendern. Abschließend wird die resultierende PDF-Datei als "test.pdf" gespeichert Dieser Code demonstriert die nahtlose Kombination von TestConsoleLib für die Formatierung und IronPDF für die PDF-Erzeugung und bietet eine unkomplizierte Lösung für die Einbindung formatierter Daten in PDF-Dokumente innerhalb einer C#-Anwendung.

3.1.1. Ausgabe

4. Schlussfolgerung

Die .NET TestConsole entwickelt sich zu einer zentralen Testbibliothek für C#-Anwendungen und bietet einen besonderen Ansatz für Unit-Tests, der die Herausforderungen im Zusammenhang mit großen Datensätzen und komplexen Assertions lindert. Die TestConsole.Core-Variante erweitert ihren Nutzen auf verschiedene Umgebungen, schließt Lücken, die andere Frameworks hinterlassen haben, und bietet einen effizienten Arbeitsablauf für Seite-an-Seite-Vergleiche von formatierten Ausgaben.

Es lässt sich nahtlos integrieren inIronPDFeine robuste C#-Bibliothek, die nicht nur das Testen vereinfacht, sondern auch die PDF-Erzeugung und -Manipulation ermöglicht. Zusammen ermöglichen diese Tools Entwicklern die mühelose Bewältigung komplizierter Tests und die Verbesserung der Dokumentenerstellung in ihren C#-Projekten und bieten eine umfassende und effiziente Lösung.

Die ausführliche und vollständige Anleitung zur Konvertierung von IronPDF HTML in PDF finden Sie unterdas IronPDF-Einführungshandbuch.