Python XlsxWriter - 重要类

---

XlsxWriter 库由以下类组成。这些类中定义的所有方法都允许以编程方式对 XLSX 文件执行不同的操作。课程是 -

• 作业本类
• 工作表类
• 格式类
• 图表类
• 图表类
• 异常类

练习册班

这是 XlsxWriter 模块公开的主类，也是您需要直接实例化的唯一类。它代表写入磁盘上的 Excel 文件。

wb=xlsxwriter.Workbook('filename.xlsx')

Workbook 类定义了以下方法 -

工作表类

工作表类代表 Excel 工作表。此类的对象处理诸如将数据写入单元格或格式化工作表布局等操作。它是通过从Workbook()对象调用add_worksheet()方法创建的。

Worksheet 对象可以访问以下方法 -

格式类

格式对象是通过调用工作簿add_format()方法创建的。该对象可用的方法和属性与字体、颜色、图案、边框、对齐方式和数字格式有关。

字体格式化方法和属性 -

对齐格式设置方法和属性

图表类

图表对象是通过指定图表类型的 Workbook 对象的add_chart()方法创建的。

chart = workbook.add_chart({'type': 'column'})

通过调用insert_chart()方法将图表对象插入到工作表中。

worksheet.insert_chart('A7', chart)

XlxsWriter 支持以下图表类型 -

• 区域- 创建区域（实心线）样式图表。

• bar - 创建条形样式（转置直方图）图表。

• 柱- 创建柱形（直方图）图表。

• line - 创建线条样式图表。

• pie - 创建饼图样式图表。

• 甜甜圈- 创建甜甜圈样式图表。

• scatter - 创建散点样式图表。

• stock - 创建股票样式图表。

• 雷达- 创建雷达样式图表。

Chart 类定义了以下方法 -

图表类

XLSX 文件中的图表表是仅包含图表而不包含其他数据的工作表。通过从 Workbook 对象调用add_chartsheet()方法来创建新的图表对象 -

chartsheet = workbook.add_chartsheet()

Chartsheet类的一些功能与数据工作表的功能类似，例如选项卡选择、页眉、页脚、边距和打印属性。但是，其主要目的是显示单个图表，而普通数据工作表可以包含一个或多个嵌入图表。

图表数据必须出现在单独的工作表中。因此，它总是使用set_chart()方法与至少一个数据工作表一起创建。

chartsheet = workbook.add_chartsheet()
chart = workbook.add_chart({'type': 'column'})
chartsheet.set_chart(chart)

请记住，图表表只能包含一个图表。

例子

以下代码将数据系列写入名为sheet1的工作表中，但打开一个新的图表工作表以根据sheet1中的数据添加柱形图。

import xlsxwriter

wb = xlsxwriter.Workbook('hello.xlsx')
worksheet = wb.add_worksheet()

cs = wb.add_chartsheet()
chart = wb.add_chart({'type': 'column'})

data = [
   [10, 20, 30, 40, 50],
   [20, 40, 60, 80, 100],
   [30, 60, 90, 120, 150],
]
worksheet.write_column('A1', data[0])
worksheet.write_column('B1', data[1])
worksheet.write_column('C1', data[2]) 

chart.add_series({'values': '=Sheet1!$A$1:$A$5'})
chart.add_series({'values': '=Sheet1!$B$1:$B$5'})
chart.add_series({'values': '=Sheet1!$C$1:$C$5'})

cs.set_chart(chart)
cs.activate()

wb.close()

输出

异常类

XlsxWriter 识别各种运行时错误或异常，可以使用 Python 的错误处理技术捕获这些错误或异常，从而避免 Excel 文件损坏。XlsxWriter 中的 Exception 类如下 -

文件创建错误异常

假设已使用 Excel 应用程序打开名为hello.xlsx的工作簿，则以下代码将引发FileCreateError -

import xlsxwriter
workbook = xlsxwriter.Workbook('hello.xlsx')
worksheet = workbook.add_worksheet()
workbook.close()

当该程序运行时，错误消息显示如下 -

PermissionError: [Errno 13] Permission denied: 'hello.xlsx'
During handling of the above exception, another exception occurred:
Traceback (most recent call last):
   File "hello.py", line 4, in <module>
   workbook.close()
File "e:\xlsxenv\lib\site-packages\xlsxwriter\workbook.py", line 326, in close
   raise FileCreateError(e)
xlsxwriter.exceptions.FileCreateError: [Errno 13] Permission denied: 'hello.xlsx'

处理异常

我们可以使用Python的异常处理机制来达到这个目的。

import xlsxwriter
try:
   workbook = xlsxwriter.Workbook('hello.xlsx')
   worksheet = workbook.add_worksheet()
   workbook.close()
except:
   print ("The file is already open")

现在将显示自定义错误消息。

(xlsxenv) E:\xlsxenv>python ex34.py
The file is already open

异常空图表系列

另一种情况是在图表中添加数据系列时引发异常。

import xlsxwriter
workbook = xlsxwriter.Workbook('hello.xlsx')
worksheet = workbook.add_worksheet()
chart = workbook.add_chart({'type': 'column'})
worksheet.insert_chart('A7', chart)
workbook.close()

这会导致 EmptyChartSeries 异常 -

xlsxwriter.exceptions.EmptyChartSeries: Chart1 must contain at least one data series.