使用 WinForms C# 和 VB.NET 导入和导出 CSV 文件
Spread.NET可帮助您创建电子表格、网格、仪表板和表单。它包括一个强大的计算引擎，具有 450 多个函数以及导入和导出 Microsoft Excel 电子表格的能力。开发人员可以利用广泛的 .NET 电子表格 API 和强大的计算引擎来创建分析、预算、仪表板、数据收集和管理、科学和财务应用程序。
在此博客中，MESCIUS 产品经理 Kevin Ashley 将带您完成使用 Spread.NET 导入和导出 CSV 文件中的数据所需的所有步骤，包括：
- 创建/配置项目
- 创建文件菜单
- 创建/配置SplitContainer
- 添加事件处理程序代码
- ...以及更多！
将在运行时使用 Spread Designer 工具，只需一行代码即可在运行的应用程序中编辑 Excel 电子表格实例。最后，我将展示如何创建一个简单的前端电子表格用户界面，将 FpSpread 电子表格控件与 NameBox和 FormulaTextBox 控件集成，使用分割窗格创建主用户界面，以及如何实现菜单项来处理 文件 - C# 和 VB中的“打开”、“文件 - 保存”和 “文件 - 设计” 命令 。
以下是在 C# 和 VB.net WinForms 中导入和导出 CSV 文件的步骤：
- 创建项目
- 配置项目
- 创建文件菜单
- 创建SplitContainer1
- 配置SplitContainer1
- 创建SplitContainer2
- 创建 FpSpread
- 创建名称框
- 创建公式文本框
- 创建 WinForms 电子表格设计器组件
- 为文件菜单项创建事件处理程序
- 添加事件处理程序代码
这些步骤需要：
- Microsoft Visual Studio 2022（注意：虽然这些步骤适用于 VS2022 和 .NET 6，但 Spread.NET WinForms 也可以在面向 .NET 4.6.2+ 的早期版本的 Visual Studio 中工作，遵循这些相同的步骤）
- Spread.NET for WinForms（试用版或许可版）- 在此处获取 Spread.NET WinForms 的 30 天免费试用版 。
第 1 步：创建项目
我们可以首先在Visual Studio 2022中创建一个新项目 ，选择 C#、Windows和 Desktop来筛选项目，然后选择C# 或 VB WinForms App。
第 2 步：配置项目
输入 SpreadWinformsCSVIO作为 项目名称。
第 3 步：创建文件菜单
现在，让我们添加一个MenuStrip。在 “工具箱” 窗口 ( F4 ) 的“菜单和工具栏”类别下，双击 MenuStrip组件以 在窗体中创建一个新的 MenuStrip ：
通过使用关联的快捷键单击，创建 “文件 – 打开”、 “文件 – 保存”、 “文件 – 另存为”、 “文件 – 设计”和 “文件 – 退出”菜单项：
请注意， 文件 - 保存 菜单项最初应被禁用。菜单分隔符（ 对菜单项文本使用“-”来创建菜单分隔符）和快捷键是可选的，但建议使用。我们将在稍后的步骤中为这些菜单项添加代码。
步骤4：创建SplitContainer1
注意： 使用 FpSpread 并不一定需要添加拆分器，但 SplitContainer 控件使创建友好且灵活的电子表格界面变得更加容易，因为它会自动处理电子表格、名称框和公式文本框控件的大小调整，而无需任何代码。
在 工具箱 ( CTRL+ALT+X ) 中，展开Containers类别 ，然后双击 SplitContainer 控件以创建 splitContainer1：
步骤5：配置SplitContainer1
在 “属性” 窗口 ( F4 ) 中，对于 splitContainer1，将 Orientation设置 为 Horizontal，然后将 Panel1MinSize 和 SplitterDistance设置 为 23：
电子表格将位于底部窗格中，编辑栏界面将位于顶部窗格中，拆分器将确定FormulaTextBox控件的高度， 以显示换行的长公式。
第6步：创建SplitContainer2
在 工具箱 ( CTRL+ALT+X ) 中，将新的SplitContainer拖放 到splitContainer1的 顶部窗格 ( Panel1 ) 内 以创建 splitContainer2：
在 “属性” 窗口 ( F4 ) 中，对于 splitContainer2，将Panel1MinSize 和 SplitterDistance 设置 为 150：
第 7 步：创建 FpSpread
在 “解决方案资源管理器”中，展开 “解决方案 SpreadNetQuickStart” 和 “项目 SpreadNetQuickStart”，然后右键单击 “依赖项” 并选择 “管理 NuGet 包...” （或按 ALT+P+N+N+N+ENTER）：
然后，在NuGet Package Manager中，选择 左上角的 Browse ，然后 在搜索框中 键入Spread.WinForms以查找最新的GrapeCity.Spread.WinForms，然后单击 Install：
安装 GrapeCity.Spread.WinForms后，继续安装 GrapeCity.Spread.WinForms.Design – 该软件包包含 fpSpreadDesigner 组件，用于在运行时显示 Spread Designer 工具。
然后，在工具箱 ( CTRL+ALT+X ) 中，选择 FpSpread 控件：
最后，将FpSpread的实例绘制 到SplitContainer1的 底部窗格 ( Panel2 ) 中。当您创建控件时， Spread 设计器工具 可能会打开（这是默认行为） - 现在， 如果出现 ，请关闭Spread 设计器。
使用 属性网格 (F4)，将 Dock 属性设置为 Fill：
第 8 步：创建名称框
在 工具箱 ( CTRL+ALT+X ) 中，展开GrapeCity Spread for WinForms的类别 ，然后选择 NameBox 控件：
在左上角的 Panel1 ( SplitContiner2.Panel1 ) 内绘制一个新的 NameBox：
在 “属性” 窗口 ( F4 ) 中，对于 nameBox1，将Dock 设置 为 Fill：
在nameBox1的右上角 ，单击指示器打开 NameBox Tasks，然后单击 AttachTo 下拉列表并选择 fpSpread1 – 这将以代码隐藏形式生成代码，以将 NameBox 控件附加到 FpSpread 控件：
第 9 步：创建 FormulaTextBox
在 工具箱 ( CTRL+ALT+X ) 中，展开 容器 并选择 面板 控件：
在Panel2内 （ NameBox1 右侧 ），绘制一个新的 Panel：
在 “属性” 窗口 ( F4 ) 中，对于 panel1，将BorderStyle 设置 为 FixSingle 并将 Dock设置 为 Fill：
在 工具箱 (CTRL+ALT+X) 中， 选择 FormulaTextBox 控件：
在panel1 （位于 splitContainer2.Panel2内部）内 ，绘制一个新的FormulaTextBox 控件：
在 FormulaTextBox1 的属性 窗口 ( F4 ) 中，将BorderStyle 设置 为 None 并将 Dock设置 为 Fill：
在FormulaTextBox1的右上角 ，单击指示器打开 FormulaTextBox 任务， 然后单击 AttachTo 下拉列表并选择 fpSpread1 – 这将以代码隐藏形式生成代码，以将 FormulaTextBox 控件附加到 FpSpread控件：
步骤 10：创建 WinForms 电子表格设计器组件
现在，在Toolbox 窗口 ( CTRL+ALT+X ) 的 GrapeCity Spread Design for WinForms 类别下 ， 双击 FpSpreadDesigner组件以 在表单中 创建一个新的 FpSpreadDesigner ：
刚刚添加的fpSpreadDesigner1组件 应显示在组件 menuStrip1 和fpSpread1_Sheet1旁边的表单组件托盘中：
步骤 11：为文件菜单项创建事件处理程序
对于“文件”菜单中的每个菜单项 ，在设计视图中双击该菜单项，直到每个菜单项都有一个在 VB 或 C# 代码中生成的关联菜单处理程序：
第 12 步：添加事件处理程序代码
复制以下代码来实现事件处理程序：
[C＃]
添加事件处理程序代码 C#
private string mFileName = null;private void openToolStripMenuItem_Click(object sender, EventArgs e)
{OpenFileDialog ofd = new OpenFileDialog();ofd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*";ofd.FilterIndex = 0;if (ofd.ShowDialog() == DialogResult.OK){mFileName = ofd.FileName;fpSpread1.Sheets[0].LoadTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "");saveToolStripMenuItem.Enabled = true;}
}private void saveToolStripMenuItem_Click(object sender, EventArgs e)
{fpSpread1.Sheets[0].SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "");
}private void saveAsToolStripMenuItem_Click(object sender, EventArgs e)
{SaveFileDialog sfd = new SaveFileDialog();sfd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*";sfd.FilterIndex = 0;sfd.FileName = mFileName;if (sfd.ShowDialog() == DialogResult.OK){mFileName = sfd.FileName;fpSpread1.Sheets[0].SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "");saveToolStripMenuItem.Enabled = true;}
}private void designToolStripMenuItem_Click(object sender, EventArgs e)
{fpSpreadDesigner1.ShowDialog(fpSpread1);
}private void exitToolStripMenuItem_Click(object sender, EventArgs e)
{DialogResult ret = MessageBox.Show("Do you want to save this file before closing?", "Save Spreadsheet", MessageBoxButtons.YesNoCancel);if (ret == DialogResult.Cancel)return;else if (ret == DialogResult.Yes)saveToolStripMenuItem_Click(null, EventArgs.Empty);Close();
}[VB]
添加事件处理程序代码 VB
Private mFileName As String = NothingPrivate Sub OpenToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles OpenToolStripMenuItem.ClickDim ofd As New OpenFileDialogofd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*"ofd.FilterIndex = 0If ofd.ShowDialog() = DialogResult.OK ThenmFileName = ofd.FileNameFpSpread1.Sheets(0).LoadTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")SaveToolStripMenuItem.Enabled = TrueEnd If
End SubPrivate Sub SaveToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles SaveToolStripMenuItem.ClickFpSpread1.Sheets(0).SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")
End SubPrivate Sub SaveAsToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles SaveAsToolStripMenuItem.ClickDim sfd As SaveFileDialog = New SaveFileDialog()sfd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*"sfd.FilterIndex = 0sfd.FileName = mFileNameIf sfd.ShowDialog() = DialogResult.OK ThenmFileName = sfd.FileNameFpSpread1.Sheets(0).SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")SaveToolStripMenuItem.Enabled = TrueEnd If
End SubPrivate Sub DesignToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles DesignToolStripMenuItem.ClickFpSpreadDesigner1.ShowDialog(FpSpread1)
End SubPrivate Sub ExitToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles ExitToolStripMenuItem.ClickDim ret As DialogResult = MessageBox.Show("Do you want to save this file before closing?", "Closing", MessageBoxButtons.YesNoCancel)If ret = DialogResult.Cancel ThenReturnElseIf ret = DialogResult.Yes ThenSaveToolStripMenuItem_Click(Nothing, EventArgs.Empty)End IfClose()
End Sub文件 - 打开的代码 使用 OpenFileDialog 浏览 CSV 文件，然后使用 FpSpread.Sheets.LoadTextFile方法打开选定的 CSV 文件。文件 - 保存的代码 使用 FpSpread.Sheets.SaveTextFile将电子表格数据保存到 CSV，文件- 另存为的代码 使用 SaveFileDialog 允许用户将文件保存到另一个位置或使用另一个名称。此功能允许 C# 或 VB.NET CSV 文件导入和导出。
File-Design 中的代码使用 FpSpreadDesigner.ShowDialog 方法在运行时显示 Spread Designer 工具，进行更改，然后将这些更改应用回表单中的电子表格实例。最后， “文件 - 退出”中的代码 提示用户是否保存文件，然后使用 Close 方法关闭窗体。
准备好构建和运行！
该项目已准备好构建和运行。文件设计菜单将 在运行时打开Spread Designer工具，如上所示，它可以将更改应用于表单中运行的电子表格实例。了解 Spread .NET 如何让您能够在应用程序中使用 C# 或 VB.NET 将电子表格导入和导出为 CSV。
