Làm thế nào để làm việc với Core Workbook Settings trong .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (Thể loại và ngày), Workbook.DocumentProperties (Tài liệu của tác giả), Workbook.LoadDiagnostics (Tập nhật báo cáo) và SaveOptions (để lưu hành vi) Install with dotnet add package Aspose.Cells_FOSS.

Hướng dẫn từng bước

Bước 1: Cài Đặt Gói

dotnet add package Aspose.Cells_FOSS

Bước 2: nhập tên không gian

using Aspose.Cells_FOSS;
using System.Globalization;

Bước 3: Thiết lập WorkbookSettings

Workbook.Settings Trở lại a WorkbookSettings Mục tiêu Set Date1904 = true cho các tệp gốc macOS sử dụng hệ thống ngày 1904. Culture để kiểm tra số và ngày parsing local.

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);

Bước 4: Thiết lập tài liệu thuộc tính

Workbook.DocumentProperties triển lãm Title, Subject, Author, Keywords, Comments, Category, Company, và Manager Tính chất trực tiếp của dòng.

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);

Bước 5: Sử dụng SaveOptions

Workbook.Save(path, SaveOptions) chấp nhận a SaveOptions - Đối tượng để tùy chỉnh sản xuất. tính chất chính: UseSharedStrings (để giảm kích thước tệp cho các lá với dây lặp lại), ValidateBeforeSave (được xác nhận trước khi viết), và CompactStyles (Từ loại bỏ các kiểu chưa sử dụng).

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.”);


---

### Bước 6: Đọc LoadDiagnostics Sau khi sửa chữa

Sau khi tải với `TryRepairPackage = true`, kiểm tra `Workbook.LoadDiagnostics` Xem xem có sửa chữa nào không.

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>

Các vấn đề chung và Fixes

WorkbookSaveException Khi nào ValidateBeforeSave = true. Sách làm việc chứa một sự không phù hợp cấu trúc. ValidateBeforeSave tạm thời để lưu và kiểm tra các tập tin, sau đó sửa chữa nội dung có vấn đề.

Các thuộc tính tài liệu không hiển thị trong bảng thông tin tệp Excel. Hãy chắc chắn rằng bạn đang đặt các tài sản trên Workbook.DocumentProperties,Không phải Workbook.Properties.Đây là giữ lá cờ hiển thị, không phải các dây metadata.

Date1904 = true làm cho giá trị ngày thay đổi. Date1904 thay đổi thời gian sử dụng cho số serial ngày. chỉ đặt nó để true cho các tệp có nguồn gốc từ macOS Excel với hệ thống ngày 1904 được bật; hệ điều hành hỗn hợp gây ra lỗi off-by-1462 ngày.

Thường xuyên hỏi câu hỏi

Sự khác biệt giữa `WorkbookSettings` và `WorkbookProperties`?

WorkbookSettings (Thông qua Workbook.Settings(c) Có các giá trị cấu hình như Date1904 và Culture. WorkbookProperties (Thông qua Workbook.Properties* Có biểu tượng OOXML như: ShowObjects.Các dòng dữ liệu tài liệu (Title, Author, vv) sống trong Workbook.DocumentProperties.

Does `CompactStyles` Có bao giờ loại bỏ những phong cách mà tôi cần?

Không . CompactStyles Chỉ loại bỏ các phong cách không được đề cập bởi bất kỳ quy tắc ô hoặc định dạng nào trong sổ làm việc.

Tôi có thể đọc `LoadDiagnostics` Ngay cả khi không có sửa chữa được thử?

Có. The Issues Bộ sưu tập sẽ trống rỗng và cả hai HasRepairs và HasDataLossRisk sẽ trở lại false.