Python XlsxWriter - 重要类

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

• Workbook 类
• Worksheet 类
• Format 类
• Chart 类
• Chartsheet 类
• Exception 类

Workbook 类

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

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

Workbook类定义了以下方法 −

Worksheet 类

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

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

Format 类

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

字体格式化方法和属性 −

对齐格式化方法和属性

Chart 类

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

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

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

worksheet.insert_chart('A7', chart)

XlxsWriter 支持以下图表类型 −

• area − 创建面积（实线）样式图表。

• bar − 创建条形图（转置直方图）图表。

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

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

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

• doughnut − 创建圆环样式图表。

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

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

• radar − 创建雷达样式图表。

Chart类定义了以下方法 −

Chartsheet 类

XLSX 文件中的图表是只包含图表而没有其他数据的工作表。 通过调用 Workbook 对象的 add_chartsheet() 方法创建一个新的 chartsheet 对象 −

chartsheet = workbook.add_chartsheet()

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

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

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

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

示例

以下代码在工作表名称 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类如下 −

异常 FileCreateError

假设名为 hello.xlsx 的工作簿已使用 Excel 应用程序打开，则以下代码将引发 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

异常 EmptyChartSeries

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

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.