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

使用 WinForms C# 和 VB.NET 导入和导出 CSV 文件

2023 年 11 月 17 日

使用 Spread.NET 直接在 .NET WinForms 应用程序中处理 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：

SplitContainer 1 属性

电子表格将位于底部窗格中，编辑栏界面将位于顶部窗格中，拆分器将确定FormulaTextBox控件的高度，以显示换行的长公式。

第6步：创建SplitContainer2

在 工具箱 ( CTRL+ALT+X ) 中，将新的SplitContainer拖放到splitContainer1的顶部窗格 ( Panel1 ) 内以创建 splitContainer2：

拆分容器 2

在 “属性” 窗口 ( F4 ) 中，对于 splitContainer2，将Panel1MinSize 和 SplitterDistance 设置为 150：

SplitContainer2 属性

第 7 步：创建 FpSpread

在 “解决方案资源管理器”中，展开 “解决方案 SpreadNetQuickStart” 和 “项目 SpreadNetQuickStart”，然后右键单击 “依赖项” 并选择 “管理 NuGet 包...” （或按 ALT+P+N+N+N+ENTER）：

管理 NuGet 包

然后，在NuGet Package Manager中，选择左上角的 Browse ，然后在搜索框中键入Spread.WinForms以查找最新的GrapeCity.Spread.WinForms，然后单击 Install：

NuGet 包管理器

安装 GrapeCity.Spread.WinForms后，继续安装 GrapeCity.Spread.WinForms.Design – 该软件包包含 fpSpreadDesigner 组件，用于在运行时显示 Spread Designer 工具。

然后，在工具箱 ( CTRL+ALT+X ) 中，选择 FpSpread 控件：

FpSpread工具箱

最后，将FpSpread的实例绘制到SplitContainer1的底部窗格 ( Panel2 ) 中。当您创建控件时， Spread 设计器工具可能会打开（这是默认行为） - 现在，如果出现，请关闭Spread 设计器。

Fp传播形式

使用 属性网格 (F4)，将 Dock 属性设置为 Fill：

FpSpread 扩展坞

第 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：

面板 2 表格

在 “属性” 窗口 ( F4 ) 中，对于 panel1，将BorderStyle 设置为 FixSingle 并将 Dock设置为 Fill：

面板 1 属性

在 工具箱 (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 ：

FpSpread 设计器工具箱

刚刚添加的fpSpreadDesigner1组件应显示在组件 menuStrip1 和fpSpread1_Sheet1旁边的表单组件托盘中：

FpSpread 设计器表单

步骤 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 方法关闭窗体。