9 workbook.add_worksheet()
优质
小牛编辑
139浏览
2023-12-01
workbook.add_worksheet()
add_worksheet()
([name]) 添加一个工作表worksheet到工作簿workbook中。
- 参数: name(字符串)——可选的工作表名称,默认为Sheet1,以此类推。
- 返回类型:一个工作表对象。
- 抛出:
- DuplicateWorksheetName:如果使用重复的工作表名称。
- InvalidWorksheetName:如果使用了无效的工作表名称。
- ReservedWorksheetName:如果使用了保留的工作表名称。
add_wordsheet()
方法用于向workbook工作簿中添加一个新的worksheet工作表。
一个workbook工作簿中至少要添加一个worksheet工作表,worksheet对象用于写入数据,并配置在workbook中工作。
name
参数是可选的,如果未指定或为空,则将按照Excel默认的设置,即Sheet1、Sheet2等:
worksheet1 = workbook.add_worksheet() # Sheet1
worksheet2 = workbook.add_worksheet('Foglio2') # Foglio2
worksheet3 = workbook.add_worksheet('Data') # Data
worksheet4 = workbook.add_worksheet() # Sheet4
worksheet的名称必须是有效的Excel工作表名称:
- 不能超过32个字符。否则将会触发
InvalidWorksheetName
异常; - 不能包含这些字符:
[ ] : * ? / \
,否则将会触发InvalidWorksheetName
异常; - 不能以逗号开头或结尾,否则将会触发
InvalidWorksheetName
异常; - 不能使用重复的
name
名称,否则将会触发DuplicateWorksheetName
异常; - 不能使用Excel保留的“History”作为工作表名,否则将会触发
ReservedWorksheetName
异常;
Microsoft Office文档中有关如何重命名工作表的解释了Excel中工作表名称的规则。