Python XlsxWriter 重要类

XlsxWriter 库包含以下类。这些类中定义的所有方法都允许以编程方式对 XLSX 文件执行不同的操作。班级是：

• 工作簿类
• 工作表类
• 格式类
• 图表类
• 图表类
• 异常类

工作簿类

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

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

Workbook 类定义了以下方法：

工作表类

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

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

格式类

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

字体格式化方法和属性：

对齐格式方法和属性

图表类

图表对象是通过 添加图表() 指定图表类型的 Workbook 对象的方法。

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

The chart 通过调用将对象插入到工作表中 插入图表() method.

worksheet.insert_chart('A7', chart)

XlxsWriter 支持以下图表类型：

• area ： 创建一个区域(实线)样式的图表。

• bar ： 创建条形(转置直方图)图表。

• column ： 创建柱形(直方图)图表。

• line ： 创建线型图表。

• pie ： 创建饼图样式。

• doughnut ： 创建一个甜甜圈风格的图表。

• scatter ： 创建Scatter 样式图表。

• stock ： 创建股票风格图表。

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

Chart 类定义了以下方法：

图表类

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

chartsheet = workbook.add_chartsheet()

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

数据为 图表表 图表必须出现在单独的工作表上。因此，它始终与至少一个数据工作表一起创建，使用 设置图表() method.

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 类如下：

异常文件创建错误

假设一个名为 你好.xlsx 已使用 Excel 应用程序打开，则以下代码将引发 文件创建错误 ：

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.