可用于:用户界面的ASP。NET MVC | 用户界面的ASP。净AJAX | Blazor用户界面 | WPF的用户界面 | WinForms的UI | Xamarin的UI | WinUI的用户界面 | 用户界面的ASP。网络核心 | .NET MAUI的用户界面

Telerik文档处理?下载30天免费试用

工作簿

本文将帮助您熟悉工作簿的概念及其特性。

什么是工作簿?

工作簿是用于操作和存储数据的主要文档。工作簿也可以描述为工作表的集合,其中工作表又定义为按行和列组织的单元格的集合。每个工作簿至少包含一个工作表,并且通常包含几个带有相关信息的工作表。

工作簿的设计目的是将多个工作表放在一起,以便有效地组织和合并数据。通常,工作簿包含带有相关数据的工作表。

iworkbookexport和IWorkbookImporter接口

RadSpreadStreamProcessing时,工作簿由IWorkbookExporter而且IWorkbookImporter接口接口。这些接口定义了要添加的成员工作表,解析它们,并访问工作簿的单元格样式。

IWorkbookExporter负责导出工作簿。由于不同文件格式的特殊性,此接口的不同具体实例负责文档的创建和导出。导入with时也是如此IWorkbookImporter

使用IWorkbookExporter

方法获取iworkbookexport的实例CreateWorkbookExporter ()的方法SpreadExporter.createworkbookexport()方法的第一个参数指定将用于保存文档的文件格式,第二个参数表示将保存文档的流。

来自的代码示例1创建空工作簿并将其导出到XLSX文件。

例1:创建iworkbookexport

使用(FileStream流= File.OpenWrite("sample.xlsx")){使用(iworkbookexport工作簿= spreadadexporter . createworkbookexport (SpreadDocumentFormat.Xlsx,流)){使用(iworksheetexport工作表=工作簿。createworksheetexport ("First sheet")) {using (irowexport row = worksheet. createrowexport ()) {}}}}

向现有文档追加内容

CreateWorkbookExporter方法创建一个新的工作簿,如果工作簿不为空,则该工作簿将覆盖流中包含的文档的内容。您可以通过使用createworkbookexport方法的第二次重载并显式传递导出模式来改变这一点。您可以通过方法的最后一个参数(exportMode)来实现这一点,该参数为类型SpreadExportMode.spradexportmode是一个枚举,公开了两个常量-创建而且附加.默认的导出模式是Create,它会覆盖流的内容。如果将导出模式设置为附加,如果流中有任何内容,则流中的现有工作簿将被打开。然后您可以将新内容附加到已经存在的文档中。

例2:创建iworkbookexport并从流中追加内容

iworkbookexport workbook = createworkbookexport (SpreadDocumentFormat.Xlsx, stream, spreadadexportmode . append);

iworkbookexport继承自IDisposable.确保对象在使用完毕后被释放。否则,导出的文件中不会写入内容。确保正确处理此问题的最佳方法是将其包装在使用声明。

在电子表格文档中,工作表的名称是唯一的。如果尝试添加工作簿中已经存在的名称的工作表,则会得到ArgumentException.这就是GetSheetInfos ()方法会派上用场。该方法返回有关工作簿中当前存在的工作表(导入或添加)的信息。它可用于在将工作表追加到现有工作簿时检查特定工作表名称是否可用(尚未存在)。示例3演示如何使用它。

例3:使用iworkbookexport . getsheetinfo ()

using (iworkbookexport workbookexport = createworkbookexport (SpreadDocumentFormat.Xlsx, stream)) {IEnumerable sheetInfos = workbookexport . getsheetinfo ();string firstNameSheet = sheetinfo . first ().Name;}
由于CSV格式没有多表的概念,因此为CSV文档调用GetSheetInfos()将返回一个空集合。

属性中的可运行示例显示如何将工作表追加到现有工作簿SDK库在GitHub上。

使用IWorkbookImporter读取文件

IWorkbookImporter接口是读取文档的入口点,允许您迭代工作表导入器。方法可以获得IWorkbookImporter的实例CreateWorkbookImporter ()的方法SpreadExporter.CreateWorkbookImporter()方法的第一个参数指定将导入的文档的文件格式,第二个参数表示包含文件数据的流。有关如何读取数据的详细信息,请检查进口帮助主题。

另请参阅

在本文中
Baidu
map