- Làm việc với Spreadsheet Management

Các Workbook lớp là điểm đầu tiên cho tất cả các hoạt động bảng điều khiển trong Aspose.Cells FOSS for C++. Nó cung cấp phương pháp để tạo sổ làm việc mới, tải các tập tin XLSX hiện có, quản lý bảng tính và tiết kiệm kết quả.

Tạo một cuốn sách mới

Instantiate Workbook để tạo sổ làm việc trống. một bảng tính mặc định được tạo tự động.

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Summary");
    workbook.Save("output.xlsx");
    return 0;
}

tải một sổ làm việc hiện có

Đi qua một file path đến Workbook nhà xây dựng để tải một tệp XLSX hiện có. Sau khi tải, bảng tính và dữ liệu ô được truy cập ngay lập tức.

Workbook workbook("existing.xlsx");
Worksheet& sheet = workbook.GetWorksheets()[0];
// Access or modify cells here
workbook.Save("modified.xlsx");

Thiết lập các thuộc tính bảng việc làm

Các Worksheet lớp tiết lộ các thuộc tính hiển thị và bảo vệ. Sử dụng chúng để thiết lập khả năng hiển hiện lá, màn hình mạng, zoom, và màu sắc tab.

Worksheet& sheet = workbook.GetWorksheets()[0];
sheet.SetName("Data");
sheet.SetShowGridlines(false);
sheet.SetShowRowColumnHeaders(true);
sheet.SetZoom(80);

Bảo vệ và không bảo vệ một bảng tính

Call Worksheet::Protect để khóa một tờ chống lại các bản chỉnh sửa, và Worksheet::Unprotect Để loại bỏ bảo vệ:

sheet.Protect("password");
// ... distribute the workbook ...
sheet.Unprotect("password");

Bảo đảm một bảng và phạm vi tên nhất định

Khi thêm nhiều bảng tính lập trình, sử dụng Workbook::EnsureUniqueSheetName để tránh các cuộc xung đột tên. sử dụng Workbook::EnsureValidDefinedNameScope để xác nhận rằng tên được định nghĩa được phân loại đúng cách.

workbook.EnsureUniqueSheetName();
workbook.EnsureUniqueDefinedName();

Tiết kiệm một Workbook

Call Workbook::Save(fileName) để viết sổ làm việc vào đĩa. nhiều tải lên chấp nhận một tên tệp, dòng hoặc một cụ thể SaveFormat.

workbook.Save("products.xlsx");

Mẹo và Thực hành Tốt nhất

Luôn gọi Workbook::Dispose() khi được thực hiện với một sổ làm việc để phát hành các nguồn lực không được quản lý.
Tên bảng việc phải độc đáo trong một sổ làm việc - sử dụng EnsureUniqueSheetName sau khi thêm batch.
Set Đặt Worksheet::SetShowGridlines(false) cho các bảng biểu mẫu kiểu trình bày để cải thiện khả năng đọc.
Sử dụng Worksheet::SetZoom(value) để thiết lập mức zoom mặc định (khoảng phần trăm) cho các dạng xem bảng tính.
Màu sắc được phân bổ qua Worksheet::SetTabColor giúp người dùng phân biệt các bảng tính trực quan.

Các vấn đề thường gặp

Issue	Cause	Fix Đặt
File không tìm thấy trên load	Đường sai lầm	Sử dụng con đường tuyệt đối hoặc xác minh thư mục làm việc
Tên danh sách Collision	Lặp tên khi thêm lá thư	Call `EnsureUniqueSheetName()` Sau mỗi lần thêm
Thay đổi sổ làm việc không được tiết kiệm	`Save` Không gọi	Luôn gọi `workbook.Save(path)` Trước khi ra đi
Lời cảnh báo Memory Leak	`Dispose` Không gọi	Call `workbook.Dispose()` Cuối cùng của scope

Tóm tắt Tham chiếu API

lớp học / phương pháp	Description
`Workbook()`	Tạo một sổ làm việc trống mới
`Workbook(filePath)`	Tải về một tệp XLSX hiện có
`Workbook::Save(fileName)`	Tiết kiệm sổ làm việc trên đĩa
`Workbook::EnsureUniqueSheetName()`	Giải quyết tên bảng đôi
`Workbook::Dispose()`	Giải phóng tài nguyên
`Worksheet::SetName(name)`	Đổi lại bảng tính
`Worksheet::SetShowGridlines(bool)`	Touglas đường dây hiển thị
`Worksheet::SetZoom(percent)`	Tỷ lệ zoom mặc định
`Worksheet::Protect(password)`	Lock the worksheet (Hãy khóa sổ làm việc)
`Worksheet::Unprotect(password)`	Khóa sổ làm việc

- Làm việc với Spreadsheet Management