Test Console Application C#（開發者的工作原理）

1.簡介：TestConsole

TestConsole 是一個多功能的測試函式庫，在 C# 程式語言中引入了獨特的單元測試方法。 傳統的單元測試方法在處理大型資料集和複雜斷言時經常面臨挑戰，導致難以辨識預期結果與實際結果之間的差異。 有鑑於此，TestConsole 提供了新穎的工作流程，從傳統的預測方式轉變為將格式化輸出與指定的"認可"標準輸出版本進行並排比較。

在這個函式庫中，尤其是 TestConsole，".Core"變體擴充了從原始 TestConsole 專案繼承的格式化功能，並在測試結果與預期有偏差的情況下，加入必要的測試核准功能。 TestConsole.Core 可與建立伺服器無縫整合，以觸發測試失敗。 在開發電腦上，預設情況下，它提供可重新設定的功能，以利用已安裝的檔案比較公用程式來顯示差異。 值得注意的是，此方法可簡化核准程序，讓開發人員在預期會出現差異時，可手動更新已核准的版本。

1.1.為何使用 TestConsole？

TestConsole.Core 從 ApprovalTests 擷取靈感，但其與眾不同之處在於可同時支援撰寫完整 Framework 與 .NET Core 測試套件。 該函式庫可滿足在不同環境中進行測試的需求，就像出版時的 ApprovalTests，主要是迎合完整框架的情境。 TestConsole.Core 中的語法雖然與 ApprovalTests 有相似之處，但仍有差異，尤其是關於檔案比較工具的選擇和內容的直接核准。

TestConsole.Core 是為了方便在 .NET Core 應用程式碼中進行測試而開發，它的出現是為了彌補 ApprovalTests 缺乏 .NET Standard 和 .NET Core 應用程式支援所留下的缺口。 TestConsole.Core 的測試核准功能著重於實現大型資料集的有效測試，可容納使用 Test Console Output 物件格式化的資料，並將其功能擴展至處理任何純文字輸入，為 C# 中的單元測試提供全面的解決方案。

Install-Package TestConsole -Version 2.6.0

2.TestConsole 的程式碼範例

在本節中，我們將介紹如何將控制台輸出轉換為報告。 以下原始碼使用測試控制台將 Enumerable 物件轉換成格式良好的報表。

using TestConsoleLib;
using System;
using System.Linq;

// Instantiate the output class from TestConsoleLib
var output = new Output();

// Generate a collection of anonymous objects containing value, square, and string length
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });

// Format the data into a table using TestConsoleLib's method
output.FormatTable(data);

// Retrieve the formatted report as a string
string report = output.Report;

// Print the formatted report to console
Console.WriteLine(report);

using TestConsoleLib;
using System;
using System.Linq;

// Instantiate the output class from TestConsoleLib
var output = new Output();

// Generate a collection of anonymous objects containing value, square, and string length
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });

// Format the data into a table using TestConsoleLib's method
output.FormatTable(data);

// Retrieve the formatted report as a string
string report = output.Report;

// Print the formatted report to console
Console.WriteLine(report);

Imports TestConsoleLib
Imports System
Imports System.Linq

' Instantiate the output class from TestConsoleLib
Private output = New Output()

' Generate a collection of anonymous objects containing value, square, and string length
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)
})

' Format the data into a table using TestConsoleLib's method
output.FormatTable(data)

' Retrieve the formatted report as a string
Dim report As String = output.Report

' Print the formatted report to console
Console.WriteLine(report)

此 C# 程式碼片段利用 TestConsoleLib 函式庫來示範並執行一個簡單的範例，使用 TestConsole 的 Output 類別來格式化和報告表格資料。 它首先建立一個名為 output 的 Output 類別實例。 其後，它會產生一個由 10 個元素組成的集合，其中包含匿名物件，其屬性代表一個整數值、它的平方和一個長度與整數值相對應的 'I's 字串。

然後呼叫 output.FormatTable() 方法將資料格式化為表格。 格式化後的結果儲存在字串變數 report 中，最後使用 Console.WriteLine() 將其列印到控制台。 這展示了 TestConsole 的功能和能力，可輕鬆格式化和呈現表格資料，以提高單元測試或除錯情境中的可讀性。

3.IronPDF

IronPDF的官方網站為一個強大的C# PDF函式庫提供了一個全面的平台，該函式庫旨在簡化和增強在.NET應用程式中處理PDF文件的過程。 IronPDF 提供一系列全面的功能，讓開發人員可以在 C# 專案中輕鬆地建立、處理 PDF 檔案，並從 PDF 檔案中擷取內容。 IronPDF 注重靈活性和易用性，支援廣泛的功能，包括從 HTML、圖像或現有文件生成 PDF，以及加入動態內容（如圖表和表格）。

其功能延伸至合併、分割和操作 PDF 頁面，以及擷取文字和影像等功能。 無論是用於報表、文件或任何 PDF 相關工作，IronPDF 都能以可靠且多功能的解決方案脫穎而出，以最少的工作量將 PDF 功能整合至 C# 應用程式中。

安裝 IronPDF Library

Install-Package IronPdf

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
using System;
using System.Linq;

// Instantiate the output class from TestConsoleLib
var output = new Output();

// Generate a collection of anonymous objects containing value, square, and string length
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });

// Format the data into a table and obtain the formatted output as a string
output.FormatTable(data);
string report = output.Report;

// Wrap the report in HTML pre-tags to maintain formatting
var htmlContent = $"<pre>{report}</pre>";

// Initialize IronPDF renderer and render the HTML content to PDF
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF to a file
pdf.SaveAs("test.pdf");

using TestConsole.OutputFormatting;
using TestConsoleLib;
using IronPdf;
using System;
using System.Linq;

// Instantiate the output class from TestConsoleLib
var output = new Output();

// Generate a collection of anonymous objects containing value, square, and string length
var data = Enumerable.Range(0, 10)
    .Select(i => new { Value = i, Squared = i * i, String = new string('I', i) });

// Format the data into a table and obtain the formatted output as a string
output.FormatTable(data);
string report = output.Report;

// Wrap the report in HTML pre-tags to maintain formatting
var htmlContent = $"<pre>{report}</pre>";

// Initialize IronPDF renderer and render the HTML content to PDF
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

// Save the PDF to a file
pdf.SaveAs("test.pdf");

Imports TestConsole.OutputFormatting
Imports TestConsoleLib
Imports IronPdf
Imports System
Imports System.Linq

' Instantiate the output class from TestConsoleLib
Private output = New Output()

' Generate a collection of anonymous objects containing value, square, and string length
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)
})

' Format the data into a table and obtain the formatted output as a string
output.FormatTable(data)
Dim report As String = output.Report

' Wrap the report in HTML pre-tags to maintain formatting
Dim htmlContent = $"<pre>{report}</pre>"

' Initialize IronPDF renderer and render the HTML content to PDF
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

' Save the PDF to a file
pdf.SaveAs("test.pdf")

4.結論

.NET TestConsole 是 C# 應用程式的關鍵測試函式庫，提供獨特的單元測試方法，可減輕與大型資料集和複雜斷言相關的挑戰。 TestConsole.Core 變體在多樣化的環境中擴展其實用性，彌補其他框架留下的缺口，並提供有效的工作流程，以便並排比較格式化的輸出。

它與 IronPDF（一個強大的 C# 函式庫）無縫整合，不僅有助於簡化測試，還能將其功能擴展至 PDF 的產生與操作。 這些工具可讓開發人員在 C# 專案中輕鬆處理複雜的測試，並強化文件的產生，提供全面且有效率的解決方案。

有關 IronPDF HTML 至 PDF 轉換的詳細完整教學，請參閱 《IronPDF 教學指南》。