Cara Bekerja dengan Pengaturan Buku Kerja Inti di .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (lokal dan sistem tanggal), Workbook.DocumentProperties (metadata penulis), Workbook.LoadDiagnostics (laporan perbaikan), dan SaveOptions (menyimpan perilaku). Instal dengan dotnet add package Aspose.Cells_FOSS.

Panduan Langkah-Langkah

Langkah 1: Instalasi paket

dotnet add package Aspose.Cells_FOSS

Langkah 2: Impor ruang nama

using Aspose.Cells_FOSS;
using System.Globalization;

Langkah 3: Konfigurasi Pengaturan Buku Kerja

Workbook.Settings mengembalikan a WorkbookSettings objek. set Date1904 = true untuk file yang berasal dari macOS yang menggunakan sistem tanggal 1904. Set. Culture untuk mengontrol nomor dan tanggal analisis lokal.

using Aspose.Cells_FOSS;
using System.Globalization;

var wb = new Workbook();
wb.Settings.Date1904 = false;
wb.Settings.Culture = new CultureInfo("en-US");
wb.Worksheets[0].Cells["A1"].PutValue("Settings configured");
wb.Save("settings.xlsx");

var loaded = new Workbook("settings.xlsx");
Console.WriteLine("Date1904: " + loaded.Settings.Date1904);

Langkah 4: Atur Properti Dokumen

Workbook.DocumentProperties eksposor Title, Subject, Author, Keywords, Comments, Category, Company, dan Manager sebagai sifat string langsung.

using Aspose.Cells_FOSS;

var wb = new Workbook();
wb.DocumentProperties.Title = "Quarterly Report";
wb.DocumentProperties.Author = "Reporting Team";
wb.DocumentProperties.Company = "Contoso Ltd";
wb.DocumentProperties.Keywords = "quarterly, sales, 2026";
wb.Save("properties.xlsx");

var loaded = new Workbook("properties.xlsx");
Console.WriteLine("Title: " + loaded.DocumentProperties.Title);
Console.WriteLine("Author: " + loaded.DocumentProperties.Author);

Langkah 5: Gunakan SaveOptions

Workbook.Save(path, SaveOptions) menerima a SaveOptions objek untuk menyesuaikan output. Sifat-sifat utama: UseSharedStrings (mengurangi ukuran file untuk lembaran dengan string berulang), ValidateBeforeSave (menjalankan validasi sebelum menulis), dan CompactStyles (menghapus gaya yang tidak digunakan).

var wb = new Workbook(); var ws = wb.Worksheets[0]; for (var i = 0; i < 50; i++) ws.Cells[i, 0].PutValue(“Repeated text”);

var opts = new SaveOptions { UseSharedStrings = true, ValidateBeforeSave = true, CompactStyles = true, };

wb.Save(“compact.xlsx”, opts); Console.WriteLine(“Saved with SaveOptions.”);


---

### Langkah 6: Baca LoadDiagnostics Setelah Perbaikan

Setelah dimuat dengan `TryRepairPackage = true`, cek `Workbook.LoadDiagnostics` untuk melihat apakah ada perbaikan yang diterapkan.

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };
var wb = new Workbook("file.xlsx", opts);
var diag = wb.LoadDiagnostics;

Console.WriteLine("HasRepairs: " + diag.HasRepairs);
Console.WriteLine("HasDataLossRisk: " + diag.HasDataLossRisk);
foreach (var entry in diag.Issues)
    Console.WriteLine($"  [{entry.Severity}] {entry.Code}: {entry.Message}");

<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“Copy code”

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Masalah dan Fixes Umum

WorkbookSaveException saat itu ValidateBeforeSave = true. Buku kerja berisi inkonsistensi struktural. Menonaktifkan ValidateBeforeSave sementara untuk menyimpan dan memeriksa file, kemudian memperbaiki konten yang bermasalah.

Properti dokumen tidak terlihat di panel Info File Excel. Pastikan Anda mengatur properti pada Workbook.DocumentProperties, tidak Workbook.Properties.Yang terakhir berisi display flag, bukan metadata string.

Date1904 = true menyebabkan nilai tanggal untuk bergeser. Date1904 mengubah masa yang digunakan untuk nomor seri tanggal. Hanya atur ke true untuk file yang berasal dari macOS Excel dengan sistem tanggal 1904 diaktifkan; sistem pencampuran menyebabkan kesalahan off-by-1462 hari.

Pertanyaan yang sering ditanya

Apa bedanya antara `WorkbookSettings` dan (b) `WorkbookProperties`?

WorkbookSettings (melalui: Workbook.Settings) memiliki nilai konfigurasi seperti: Date1904 dan (b) Culture. WorkbookProperties (melalui: Workbook.Properties) berisi tanda tampilan OOXML seperti: ShowObjects. string metadata dokumen (judul, penulis, dll) hidup di Workbook.DocumentProperties.

Does `CompactStyles` pernah menghapus gaya yang saya butuhkan?

Tidak, aku tidak. CompactStyles hanya menghapus gaya yang tidak dirujuk oleh sel atau aturan format di buku kerja.

Bisakah aku membaca? `LoadDiagnostics` bahkan ketika tidak ada perbaikan yang dicoba?

Ya, itu. Issues koleksi akan kosong dan keduanya HasRepairs dan (b) HasDataLossRisk akan kembali. false.