9 workbook.add_worksheet()

优质
小牛编辑
132浏览
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中工作表名称的规则。