WinForms C# 导入和导出 CSV 文件 Spread.NET

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设置 为 Horizo​​ntal，然后将 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 = Nothing
 
Private Sub OpenToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles OpenToolStripMenuItem.Click
    Dim ofd As New OpenFileDialog
    ofd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*"
    ofd.FilterIndex = 0
    If ofd.ShowDialog() = DialogResult.OK Then
        mFileName = ofd.FileName
        FpSpread1.Sheets(0).LoadTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")
        SaveToolStripMenuItem.Enabled = True
    End If
End Sub
 
Private Sub SaveToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles SaveToolStripMenuItem.Click
    FpSpread1.Sheets(0).SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")
End Sub
 
Private Sub SaveAsToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles SaveAsToolStripMenuItem.Click
    Dim sfd As SaveFileDialog = New SaveFileDialog()
    sfd.Filter = "CSV file (*.csv)|*.csv| All Files (*.*)|*.*"
    sfd.FilterIndex = 0
    sfd.FileName = mFileName
    If sfd.ShowDialog() = DialogResult.OK Then
        mFileName = sfd.FileName
        FpSpread1.Sheets(0).SaveTextFile(mFileName, FarPoint.Win.Spread.TextFileFlags.None, FarPoint.Win.Spread.Model.IncludeHeaders.None, "", ",", "")
        SaveToolStripMenuItem.Enabled = True
    End If
End Sub
 
Private Sub DesignToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles DesignToolStripMenuItem.Click
    FpSpreadDesigner1.ShowDialog(FpSpread1)
End Sub
 
Private Sub ExitToolStripMenuItem_Click(sender As Object, e As EventArgs) Handles ExitToolStripMenuItem.Click
    Dim ret As DialogResult = MessageBox.Show("Do you want to save this file before closing?", "Closing", MessageBoxButtons.YesNoCancel)
    If ret = DialogResult.Cancel Then
        Return
    ElseIf ret = DialogResult.Yes Then
        SaveToolStripMenuItem_Click(Nothing, EventArgs.Empty)
    End If
    Close()
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。