Bekerja dengan Manajemen Spreadsheet

Pengelolaan Workbook class adalah titik masuk untuk semua operasi spreadsheet di Aspose.Cells FOSS for C++. Ini menyediakan metode untuk membuat buku kerja baru, memuat file XLSX yang ada, mengelola lembar kerja, dan menyimpan hasilnya.

Membuat Buku Kerja Baru

Instantiate Workbook untuk membuat buku kerja kosong. lembar kerja default dibuat secara otomatis.

#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;
}

Mengunggah Buku Kerja yang Sudah Ada

Pasang jalur file ke Workbook Konstruktor untuk memuat file XLSX yang ada. Setelah dimuat, lembar kerja dan data sel dapat diakses segera.

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

Mengkonfigurasi Properti Lembar Kerja

Pengelolaan Worksheet class mengekspos properti tampilan dan perlindungan. Gunakan ini untuk mengkonfigurasi visibilitas lembaran, tampilan kisi-kisi, zoom, dan warna tab.

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

Melindungi dan Melepaskan Lembar Kerja

Call Worksheet::Protect untuk mengunci lembar terhadap suntingan, dan Worksheet::Unprotect untuk menghapus perlindungan:

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

Memastikan Lembar Unik dan Lingkup Nama yang Ditentukan

Saat menambahkan beberapa lembar kerja secara programatis, gunakan Workbook::EnsureUniqueSheetName untuk menghindari benturan nama. Workbook::EnsureValidDefinedNameScope untuk memvalidasi bahwa nama yang didefinisikan memiliki cakupan yang benar.

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

Menyimpan Buku Kerja

Call Workbook::Save(fileName) untuk menulis buku kerja ke disk. Banyak overload menerima nama file, aliran, atau eksplisit SaveFormat.

workbook.Save("products.xlsx");

Tips dan Praktik Terbaik

Selalu menelepon. Workbook::Dispose() ketika dilakukan dengan buku kerja untuk melepaskan sumber daya yang tidak dikelola.
Nama lembar kerja harus unik dalam buku kerja penggunaan EnsureUniqueSheetName setelah penambahan batch.
Set (set) Worksheet::SetShowGridlines(false) untuk lembar gaya presentasi untuk meningkatkan kebolehbacaan.
Penggunaan Worksheet::SetZoom(value) Untuk mengatur tingkat zoom default (persen) untuk tampilan lembar kerja.
Warna tab yang ditugaskan melalui Worksheet::SetTabColor membantu pengguna membedakan lembar kerja secara visual.

Masalah Umum

Issue	Cause	Perbaiki
File tidak ditemukan saat dimuat	Jalur yang salah	Gunakan jalur mutlak atau verifikasi direktori kerja
Pertentangan nama lembar	Nama duplikat saat menambahkan lembar	Call `EnsureUniqueSheetName()` setelah setiap penambahan
Perubahan buku tidak disimpan	`Save` tidak dipanggil	Selalu menelepon. `workbook.Save(path)` sebelum keluar
Peringatan kebocoran memori	`Dispose` tidak dipanggil	Call `workbook.Dispose()` di akhir cakupan

Ringkasan Referensi API

Kelas/Metode	Description
`Workbook()`	Membuat buku kerja kosong baru
`Workbook(filePath)`	Mengunggah file XLSX yang ada
`Workbook::Save(fileName)`	Menyimpan buku kerja ke disk
`Workbook::EnsureUniqueSheetName()`	Mengatasi nama lembar yang diduplikasi
`Workbook::Dispose()`	Sumber daya yang dilepaskan
`Worksheet::SetName(name)`	Mengganti nama lembar kerja
`Worksheet::SetShowGridlines(bool)`	Mengganti visibilitas garis grid
`Worksheet::SetZoom(percent)`	Menetapkan persentase zoom default
`Worksheet::Protect(password)`	Mengunci lembar kerja
`Worksheet::Unprotect(password)`	Buka lembar kerja

Bekerja dengan Manajemen Spreadsheet