إدارة الأوراق العمل

إدارة أوراق العمل باستخدام Aspose.Cells for Python via Java سهلة للغاية. في هذه المقالة، سنُظهر كيفية إضافة أوراق عمل جديدة، والوصول إليها، وإزالتها باستخدام واجهة برمجة تطبيقات Aspose.Cells.

إضافة ورقات العمل إلى ملف Excel جديد

لإنشاء كتاب عمل جديد، أنشئ كائن من الفئة Workbook. الفئة Workbook تمثل ملف Excel. ثم باستخدام طريقة add من WorksheetCollection، يتم إضافة ورق العمل الجديدة إلى ملف Excel. وأخيرًا، لحفظ ملف Excel الجديد الذي تم إنشاؤه، قم باستدعاء طريقة save من الفئة Workbook.

يوضح مقتطف الكود التالي إنشاء ملف Excel جديد وإضافة ورق عمل إليه.

  output_directory = "Examples/SampleFiles/OutputDirectory/"

  # Instantiating a Workbook object
  workbook = Workbook()

  # Adding a new worksheet to the Workbook object
  worksheets = workbook.getWorksheets()

  sheetIndex = worksheets.add()
  worksheet = worksheets.get(sheetIndex)

  # Setting the name of the newly added worksheet
  worksheet.setName("My Worksheet")
  
  # Save the excel file.
  workbook.save(output_directory + "AddingWorksheetsToNewExcelFile_out.xlsx")

إضافة ورقات عمل إلى جدول التصميم

إضافة ورق العمل إلى جدول بيانات المصمم هو بالضبط نفس إضافة ورق العمل إلى ملف Excel جديد. الفرق الوحيد هو أننا بدلاً من إنشاء ملف Excel جديد، نفتح ملفًا موجودًا بواسطة فئة Workbook.

يوضح مقتطف الكود التالي إضافة ورق عمل إلى جدول بيانات المصمم.

  source_directory = "Examples/SampleFiles/SourceDirectory/"
  output_directory = "Examples/SampleFiles/OutputDirectory/"

  # Open an existing workbook
  workbook = Workbook(source_directory + "book.xls")

  # Adding a new worksheet to the Workbook object
  worksheets = workbook.getWorksheets()

  sheetIndex = worksheets.add()
  worksheet = worksheets.get(sheetIndex)

  # Setting the name of the newly added worksheet
  worksheet.setName("My Worksheet")
  
  # Save the excel file.
  workbook.save(output_directory + "AddingWorksheetsToDesignerSpreadsheet_out.xlsx")

الوصول إلى الأوراق العمل باستخدام اسم الورقة

بعد تحميل كتاب العمل، يمكن للمطورين الوصول إلى أي ورق عمل باستخدام فهرسه أو اسمه. يوضح مقتطف الكود التالي الوصول إلى ورقة عمل باستخدام اسمها.

  source_directory = "Examples/SampleFiles/SourceDirectory/"

  workbook = Workbook(source_directory + "Book1.xlsx")
  
  # Accessing a worksheet using its sheet name
  worksheet = workbook.getWorksheets().get("Sheet1")
  cell = worksheet.getCells().get(3, 3)
  
  print(cell.getValue())

إزالة أوراق العمل

قد تكون هناك أوقات عندما يجب إزالة بعض الأوراق من كتاب العمل. لهذا، يوفر الواجهة البرمجية الخاصة به خاصية WorksheetCollection.removeAt. يمكنك تمرير فهرس الورقة أو اسم الورقة التي يجب إزالتها. توضح الأمثلة التالية إزالة أوراق العمل باستخدام فهرس الورقة واسم الورقة.

إزالة أوراق العمل باستخدام فهرس الورقة

  source_directory = "Examples/SampleFiles/SourceDirectory/"
  output_directory = "Examples/SampleFiles/OutputDirectory/"

  workbook = Workbook(source_directory + "Book1.xlsx")

  # Removing a worksheet using its sheet name
  workbook.getWorksheets().removeAt(0)

  # Save the excel file.
  workbook.save(output_directory + "RemovingWorksheetsUsingSheetIndex_out.xlsx")

إزالة الأوراق العمل باستخدام اسم الورقة

  source_directory = "Examples/SampleFiles/SourceDirectory/"
  output_directory = "Examples/SampleFiles/OutputDirectory/"

  workbook = Workbook(source_directory + "Book1.xlsx")
  
  # Removing a worksheet using its sheet name
  workbook.getWorksheets().removeAt("Sheet1")
  
  # Save the excel file.
  workbook.save(output_directory + "RemovingWorksheetsUsingSheetName_out.xlsx")