IronXL与CsvWriter的比较。

IronXL功能集

• 从 XLS/XLSX/CSV/TSV 加载、读取和编辑数据
• 保存和导出 - 至 XLS/XLSX/CSV/TSV/JSON
• 范围 - 易于使用的工作表 ["A1:B10"] 语法。 直观地组合和创建范围。
• 排序 - 对范围、列和行进行排序。
• 样式 - 单元格视觉样式、字体、大小、背景图案、边框、对齐方式和数字格式。

CsvWriter 功能

• 快速：即时编译类，性能极快
• 灵活：写作时保守，阅读时自由
• 易于使用：读取和写入操作与 GetRecords() 和 WriteRecords(records) 一样简单
• 高度可配置
• Linux 模式
• 低内存使用率

2.1. 使用包含NuGet包的Visual Studio

Visual Studio 提供 NuGet 包管理器以便在您的项目中安装 NuGet 包。 您可以通过项目菜单或通过右键点击解决方案资源管理器中的项目访问它。

选择-管理-NuGet-包

• 现在，从浏览选项卡 -> 搜索 IronXL.Excel -> 安装

搜索 IronXL

• 我们完成了。

2.2. 直接下载 NuGet 包

可以通过直接访问 NuGet 站点并下载包来完成。 步骤如下

• Navigate tohttps://www.nuget.org/packages/IronXL.Excel
• 选择 "下载软件包
• 双击下载的软件包
• 软件包将安装
• 重新加载 Visual Studio 项目并开始使用

2.3. 使用DLL手动安装

下载和安装 IronXL C# 库的另一种方法是利用以下步骤，通过开发人员命令提示符安装IronXLNuGet 软件包。

• Openthe 开发人员命令提示符- 通常位于 Visual Studio 文件夹中。
• 键入以下命令：

  Install-Package IronXL.Excel

• 按回车键
• 这将下载并安装软件包
• 重新加载 Visual Studio 项目并开始使用

2.4. 添加必要的Using指令

1.在解决方案资源管理器中，右键单击 Program.cs 文件，然后单击查看代码。 2.在代码文件顶部添加以下usingdirectives：

using IronXL;

using IronXL;

Imports IronXL

全部完成了！ IronXL已下载、安装并准备使用。 不过，在此之前，我们应该先安装 CsvHelper。

3.1.使用 NuGet 包管理器控制台。

要使用 CSVWriter，您需要下载并安装 CsvHelper C# 库。 为此，请使用以下步骤通过开发人员命令提示符安装NuGet 软件包。

• Openthe 开发人员命令提示符- 通常位于 Visual Studio 文件夹中。
• 键入以下命令：

  Install-Package CsvHelper -Version 27.2.1

• 按回车键
• 这将下载并安装软件包
• 重新加载 Visual Studio 项目并开始使用
• 查看 CsvHelper.CsvWriter 方法的实现细节

3.2.直接下载

Download from the NuGet website: https://www.nuget.org/packages/CsvHelper/

4.1.将 CSV 文件转换为 Excel 格式

过程非常简单容易。 通常只需一行代码即可完成。

CSV到Excel格式：

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and specify the format and delimiter
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Get the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

' Load the CSV file and specify the format and delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("test.csv", fileFormat:= ExcelFileFormat.XLSX, ListDelimiter:= ",")
' Get the default worksheet
Dim ws As WorkSheet = workbook.DefaultWorkSheet

' Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx")

4.2.使用 IronXL 读取和操作转换后的 CSV 文件

IronXLWorkBookclass 表示 Excel 表单。 要使用 C# 打开 Excel 文件，我们使用 WorkBook.Load 并指定 Excel 文件的路径 (.xlsx)。 以下一行代码用于打开文件以进行读取：

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

' Load WorkBook
Dim workbook = WorkBook.Load("Spreadsheets\\sample.xlsx")

每个 WorkBook 可以包含多个 WorkSheet 对象。 这些表示Excel文件中的工作表。 如果工作簿包含工作表，通过名称检索它们如下所示：

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

' Open Sheet for reading
Dim worksheet = workbook.GetWorkSheet("sheetnamegoeshere")

读取单元格值的代码：

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

' Read from Ranges of cells elegantly.
For Each cell In worksheet("A2:A10")
	Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text)
Next cell

加载并读取工作簿和工作表后，可使用以下代码示例对公式进行更改或将公式应用到特定单元格。 代码如下

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

' Set Formulas
worksheet("A1").Formula = "Sum(B8:C12)"
worksheet("B8").Formula = "=C9/C11"
worksheet("G30").Formula = "Max(C3:C7)"

' Force recalculate all formula values in all sheets.  
workbook.EvaluateAll()

4.3.将 Excel 文档保存为 CSV 文件

使用 IronXL 编写 CSV 文件非常简单。 以下代码只需使用 SaveAsCsv 方法将 Excel 文件保存为 CSV 格式即可。

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

// Load the workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");
// Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// Saved as : SaveAsCSV.Sheet1.csv

' Load the workbook
Dim wb As WorkBook = WorkBook.Load("Normal_Excel_File.xlsx")
' Save as .csv file
wb.SaveAsCsv("SaveAsCSV.csv", ",")
' Saved as : SaveAsCSV.Sheet1.csv

5.1.创建一个简单的控制台应用程序

使用 Visual Studio 创建一个简单的 CSVWriter，并提供分隔符控制台应用程序。 项目创建后，下一步就是创建一个 Person 类：

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
    public bool IsLiving { get; set; }
}

Public Class Person
	Public Property Id() As Integer
	Public Property Name() As String
	Public Property IsLiving() As Boolean
End Class

现在，让我们在 Main 方法中创建一个 Person 对象列表，并将其写入 CSV 文件：

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

var myPersonObjects = new List<Person>()
{
    new Person { Id = 1, IsLiving = true, Name = "John" },
    new Person { Id = 2, IsLiving = true, Name = "Steve" },
    new Person { Id = 3, IsLiving = true, Name = "James" }
};

Dim myPersonObjects = New List(Of Person)() From {
	New Person With {
		.Id = 1,
		.IsLiving = True,
		.Name = "John"
	},
	New Person With {
		.Id = 2,
		.IsLiving = True,
		.Name = "Steve"
	},
	New Person With {
		.Id = 3,
		.IsLiving = True,
		.Name = "James"
	}
}

5.2.使用默认设置在 C# 中写入 CSV 文件

CsvHelper 已成为使用 CSVWriter 方法在 C# 中编写 CSV 的标准方法，而且非常易于使用：

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

using (var writer = new StreamWriter("filePersons.csv"))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(myPersonObjects);
}

Using writer = New StreamWriter("filePersons.csv")
Using csv = New CsvWriter(writer, CultureInfo.InvariantCulture)
	csv.WriteRecords(myPersonObjects)
End Using
End Using

5.3.追加数据

我们需要注意的是，每次运行我们的程序时，旧的 CSV 文件都会被覆盖。 有时我们希望在文件末尾添加数据，而不是覆盖现有数据。 CSVWriter 不提供这样做的方法，因为打开/写入文件不是 CSVWriter 使用提供的分隔符的责任。 我们可以通过使用 FileStream，然后使用 FileStream 构建我们的 StreamWriter 来实现这一目标。 虽然这不属于本文的讨论范围，但我会向您展示如何进行翻译，因为这是任何应用程序都不可或缺的一部分。

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

var configPersons = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};
using (var stream = File.Open("filePersons.csv", FileMode.Append))
using (var writer = new StreamWriter(stream))
using (var csv = new CsvWriter(writer, configPersons))
{
    csv.WriteRecords(myPersonObjects);
}

Dim configPersons = New CsvConfiguration(CultureInfo.InvariantCulture) With {.HasHeaderRecord = False}
Using stream = File.Open("filePersons.csv", FileMode.Append)
Using writer = New StreamWriter(stream)
Using csv = New CsvWriter(writer, configPersons)
	csv.WriteRecords(myPersonObjects)
End Using
End Using
End Using

不过，对现有文件进行附加是一件棘手的事情，因为在附加时，排序可能会发生变化，或者我们可能添加了新的属性。 我们在附加时应确保考虑到这一点。

总结

IronXL.Excel 是一个完整的库，可提供处理 Excel 文件所需的一切功能。它可以将各种格式转换为 XLSX，也可以将 XLSX 转换为 CSV 等其他格式。这种相互转换为用户提供了轻松处理其他文件格式的灵活性。

另一方面，CSVWriter 只适用于 CSV 文件格式，而且选项非常有限。 用户不能在不同的文件格式之间切换，而使用 IronXL 则可以。 所有代码示例均可在 CsvHelper 文档文件中找到。 本文档提供了如何在您的项目中使用 CSVWriter 的指南。

结论

与 CSVHelper.CSVWriter 相比，IronXL 具有明显的优势，因为它支持处理多种格式。 此外，您还可以根据自己的选择应用公式和样式，而 CsvHelper 只允许读写 CSV 文件，且选项有限。 此外，您不能在现有 CSV 文件中添加新记录，因为这只会覆盖以前的条目。