- Sử dụng Core Workbook Settings

- Sử dụng Core Workbook Settings

Ngoài mạng lưới bảng tính, một sổ làm việc mang lại các metadata và cấu hình ảnh hưởng đến cách Excel giải thích nó: hệ thống ngày, tác giả tài liệu, địa phương, và xem thông tin phục hồi có được lưu trữ hay không. Workbook lớp này được trình bày qua Workbook.Settings, Workbook.Properties, và Workbook.LoadDiagnostics.- Sửa chữa hành vi được kiểm soát thông qua SaveOptions.

Settings Workbook thiết lập

Workbook.Settings Trở lại a WorkbookSettings Mục tiêu Set Date1904 để true để sử dụng hệ thống ngày 1904 (thường được trong các tệp có nguồn gốc từ macOS Excel). Culture đến a CultureInfo Ví dụ để kiểm tra số và ngày parsing local.

using Aspose.Cells_FOSS;
using System.Globalization;

var wb = new Workbook();

// Use 1904 date system
wb.Settings.Date1904 = true;

// Set culture for number/date formatting
wb.Settings.Culture = new CultureInfo("en-US");

wb.Worksheets[0].Cells["A1"].PutValue("Settings applied");
wb.Save("settings.xlsx");

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

Thuộc tính tài liệu

Workbook.Properties Trở lại a WorkbookProperties - Các đối tượng với các lá cờ hướng hiển thị như: ShowObjects và FilterPrivacy.Đối với tác giả và sử dụng metadata mô tả Workbook.DocumentProperties,Những gì tiết lộ 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();

var doc = wb.DocumentProperties;
doc.Title = "Quarterly Report";
doc.Subject = "Sales Data";
doc.Author = "Reporting Team";
doc.Company = "Contoso Ltd";
doc.Keywords = "sales, quarterly, 2026";
doc.Comments = "Generated by automated pipeline";

wb.Worksheets[0].Cells["A1"].PutValue("See document properties");
wb.Save("properties.xlsx");

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

Load Diagnostics Đánh giá

Sau khi tải sổ làm việc, kiểm tra Workbook.LoadDiagnostics để tìm ra liệu thư viện có thực hiện bất kỳ sửa chữa nào không. LoadDiagnostics.HasRepairs là true Nếu có ít nhất một sửa chữa cấu trúc được thực hiện. LoadDiagnostics.HasDataLossRisk là true Nếu sửa chữa dữ liệu bị mất.Iterate LoadDiagnostics.Issues Truy cập cá nhân DiagnosticEntry Các đối tượng với Code, Severity, Message, RepairApplied, và DataLossRisk.

var opts = new LoadOptions { TryRepairPackage = true, TryRepairXml = true };

try { var wb = new Workbook(“possibly-corrupt.xlsx”, opts); var diag = wb.LoadDiagnostics;

if (diag.HasRepairs)
{
    Console.WriteLine("Repairs applied: " + diag.HasRepairs);
    Console.WriteLine("Data loss risk: " + diag.HasDataLossRisk);
    foreach (var entry in diag.Issues)
    {
        Console.WriteLine($"  [{entry.Severity}] {entry.Code}: {entry.Message}");
        Console.WriteLine($"  RepairApplied={entry.RepairApplied}, DataLossRisk={entry.DataLossRisk}");
    }
}
else
{
    Console.WriteLine("File loaded cleanly.");
}

} catch (WorkbookLoadException ex) { Console.WriteLine(“Unrecoverable: " + ex.Message); }

---

### Save Options Ưu đãi

`Workbook.Save(path, SaveOptions)` chấp nhận a `SaveOptions` - Mục tiêu để tùy chỉnh sản lượng tiết kiệm. `UseSharedStrings` kiểm tra xem các giá trị string được lưu trữ trong bảng chia sẻ (được giảm kích thước tệp cho các lá có nhiều dòng lặp lại). `ValidateBeforeSave` chạy việc xác thực sổ làm việc nội bộ trước khi viết. `CompactStyles` Xóa các phong cách chưa sử dụng. `PreserveRecoveryMetadata` kiểm tra xem liệu dữ liệu khôi phục Office được lưu trữ hay không.

var wb = new Workbook();
var ws = wb.Worksheets[0];

for (var i = 0; i < 100; i++)
    ws.Cells[i, 0].PutValue("Repeated string value");

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

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

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

• Check LoadDiagnostics.HasDataLossRisk sau khi tải các tập tin được sửa chữa và cảnh báo người dùng nếu dữ liệu có thể đã bị xóa.
• Set Đặt DocumentProperties.Author và Company cho các tệp được chia sẻ với người dùng cuối — chúng xuất hiện trong bảng thông tin tàng Excel.
• UseSharedStrings = true có lợi cho các lá với nhiều giá trị chuỗi lặp lại (ví dụ: cột trạng thái); nó có tác động tối thiểu trên các tấm số nặng.
• Date1904 phải phù hợp giữa nguồn và tập tin mục tiêu để tránh biến đổi giá trị ngày khi sao chép các tế bào giữa sổ làm việc.

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

FAQ

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

WorkbookProperties (Thông qua Workbook.Properties• Có biểu tượng OOXML (ví dụ:. ShowObjects). DocumentProperties (Thông qua Workbook.DocumentProperties) giữ các đường metadata kiểu Dublin-Core: Tiêu đề, tác giả, Công ty, vv.

Does CompactStyles Tải về các phong cách tôi cần?

CompactStyles loại bỏ chỉ các phong cách không được đề cập bởi bất kỳ hình thức ô, điều kiện hoặc tên phong tục.

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

Khi không có sửa chữa đã được thử Issues Bộ sưu tập trống rỗng và cả hai HasRepairs và HasDataLossRisk trở lại false.

Tóm tắt Tham chiếu API

See Also

• Aspose.Cells for .NET — Enterprise Documentation