如何使用 Python 在 Excel 檔案中插入行

步驟 1：開啟並讀取 Excel 文件

IronXL安裝完成後，即可開始處理Excel檔案。 首先，使用 IronXL 的WorkBook類別將 Excel 檔案載入到 Python 腳本中。 此類別表示 Excel 中的工作簿對象，並提供存取和操作 Excel 文件中工作表的方法。

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

在上面的範例中，當您載入 Excel 檔案時，IronXL 會讀取二進位 Excel 檔案格式並將其轉換為可透過 Python 操作的物件。 此步驟為後續所有操作（如讀取資料、修改工作表或插入行）奠定了基礎。

步驟 2：在 Excel 表格中插入單行

使用 IronXL 在 Excel 表格中插入單行需要指定新行的位置。 WorkSheet物件的InsertRow方法可讓您指定要插入新行的行索引。 此操作會將現有行向下移動，以容納新行。

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

# Add a row before row 2 (index is zero-based)
worksheet.InsertRow(1)

# Save changes to the file
workbook.Save()

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

# Add a row before row 2 (index is zero-based)
worksheet.InsertRow(1)

# Save changes to the file
workbook.Save()

行索引的選擇至關重要，因為它決定了新資料在 Excel 工作表中的顯示位置。 必須確保此操作不會覆蓋現有數據，除非是預期行為。

如何使用 Python 在 Excel 檔案中插入一行：圖 2 - 輸出：使用 IronXL for Python 以程式設計方式在 Excel 檔案中插入一行新。

步驟 3：在 Excel 表格中插入多行

同樣，要插入多行，可以使用InsertRows方法並指定要插入的行數。 當您需要在現有表格中新增大量資料時，此功能尤其有用。

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

# Insert three rows after row 3 (index is zero-based)
worksheet.InsertRows(3, 3)

# Save changes to the file
workbook.Save()

from ironxl import *     

# Set your IronXL license key
License.LicenseKey = "License-Key"

# Load the Excel workbook
workbook = WorkBook.Load("Sample.xlsx")
worksheet = workbook.DefaultWorkSheet

# Insert three rows after row 3 (index is zero-based)
worksheet.InsertRows(3, 3)

# Save changes to the file
workbook.Save()

如何使用 Python 在 Excel 檔案中插入行：圖 3 - 輸出：使用 IronXL for Python 以程式設計方式在 Excel 檔案中插入多個新（空白）行。

步驟 4：格式化插入的行

插入行之後，通常需要將其格式設定為與工作表其餘部分的樣式相匹配，或突出顯示新資料。 IronXL 支援多種格式設定選項，包括字型變更、色彩填滿等。 正確的格式設定可以讓您的 Excel 檔案更易讀、更專業。

步驟 5：儲存 Excel 檔案的更改

使用 IronXL 對 Excel 檔案所做的所有變更都會保留在記憶體中，直到您將工作簿儲存回檔案。 WorkBook類別的Save方法會將所有變更寫入磁碟。 這步驟至關重要，因為它能確保您所做的所有修改都能保留下來。

# Save the Excel file
workbook.Save("updated.xlsx")
# You can also save as other formats such as CSV, TSV, JSON, XML, HTML, etc.
# workbook.SaveAs("updated.xlsx");

# Save the Excel file
workbook.Save("updated.xlsx")
# You can also save as other formats such as CSV, TSV, JSON, XML, HTML, etc.
# workbook.SaveAs("updated.xlsx");

錯誤處理和常見問題調試

錯誤處理是處理檔案的重要方面，因為它能確保腳本能夠優雅地處理意外情況，例如檔案遺失、資料損壞或權限問題。 IronXL 提供清晰的錯誤訊息，有助於在開發過程中調試問題。