วิธีทํางานกับการตั้งค่าตารางงานหลักใน .NET

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (ระบบสถานที่และวัน), Workbook.DocumentProperties (เมตาข้อมูลของผู้เขียน), Workbook.LoadDiagnostics (รายงานการซ่อม) และ SaveOptions (การเก็บพฤติกรรม) ติดตั้งด้วย dotnet add package Aspose.Cells_FOSS.

คู่มือขั้นตอนตามขั้นตอนนี้

ขั้นตอนที่ 1: ติดตั้งแพคเกจ

dotnet add package Aspose.Cells_FOSS

ขั้นตอนที่ 2: นําเข้า Namespace

using Aspose.Cells_FOSS;
using System.Globalization;

ขั้นตอน 3: ปรับแต่งการตั้งค่าสมุดงาน

Workbook.Settings กลับ a WorkbookSettings วัตถุ กําหนด Date1904 = true สําหรับไฟล์ที่มาจาก macOS ที่ใช้ระบบวันที่ 1904. Set Culture เพื่อควบคุมเลขและวันที่ในการพารัสท้องถิ่น.

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

ขั้นตอนที่ 4: กําหนด Properties ของเอกสาร

Workbook.DocumentProperties เผยแพร่ Title, Subject, Author, Keywords, Comments, Category, Company,และ Manager เป็นคุณสมบัติของเส้นตรง.

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

ขั้นตอน 5: ใช้ SaveOptions

Workbook.Save(path, SaveOptions) ยอมรับการ SaveOptions เป้าหมายในการปรับแต่งผลิต คุณสมบัติหลัก: UseSharedStrings (ลดขนาดไฟล์สําหรับใบที่มีเส้นซ้ํา), ValidateBeforeSave (การตรวจสอบก่อนเขียน) และ CompactStyles (ลบสไตล์ที่ไม่ใช้).

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


---

### ขั้นตอนที่ 6: อ่าน LoadDiagnostics หลังจากการซ่อมแซม

หลังจากการบรรจุด้วย `TryRepairPackage = true`, เช็ค `Workbook.LoadDiagnostics` เพื่อดูว่ามีการซ่อมแซมหรือไม่.

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>

ปัญหาทั่วไปและข้อกําหนด

WorkbookSaveException เมื่อไหร่ ValidateBeforeSave = true. หนังสืองานมีความไม่สอดคล้องทางโครงสร้าง Disable ValidateBeforeSave เพื่อบันทึกและตรวจสอบไฟล์ชั่วคราว แล้วแก้ไขเนื้อหาที่มีความเดือดร้อน.

คุณสมบัติของเอกสารไม่เห็นในแผ่นข้อมูลไฟล์ Excel. ให้แน่ใจว่าคุณจะตั้งสมบัติบน Workbook.DocumentProperties, ไม่ Workbook.Properties. ล่าสุดมีการแสดงร่องรอย, ไม่ใช่เส้นเมตาเดทา.

Date1904 = true ทําให้ค่าวันที่เปลี่ยนไป. Date1904 เปลี่ยนยุคที่ใช้สําหรับเลขเรียงของวัน. เพียงตั้งมันเป็น true สําหรับไฟล์ที่มาจาก macOS Excel โดยมีระบบวัน 1904 เปิด; ระบบผสมจะทําให้เกิดความผิดพลาดนอก 1462 วัน.

คําถามที่พบบ่อย

ความแตกต่างระหว่าง `WorkbookSettings` และ `WorkbookProperties`?

WorkbookSettings (ผ่านทาง Workbook.Settings) มีค่าการตั้งค่า เช่น Date1904 และ Culture. WorkbookProperties (ผ่านทาง Workbook.Properties) มีสัญลักษณ์การแสดง OOXML เช่น ShowObjects. หลักฐานการใช้งานของเอกสาร (ชื่อ, ผู้เขียน เป็นต้น) อยู่ใน Workbook.DocumentProperties.

Does `CompactStyles` จะเอาสไตล์ที่ต้องการออกไปบ้างไหม?

ไม่นะครับ. CompactStyles ลบ Style เท่านั้นที่ไม่ได้มีการอ้างอิงโดยเซลล์หรือกฎรูปแบบใด ๆ ในหนังสือทํางาน.

ฉันอ่านได้มั้ย? `LoadDiagnostics` แม้ว่าไม่มีการพยายามแก้ไขมัน?

ใช่ครับ Issues การเก็บของจะว่าง และทั้งสอง HasRepairs และ HasDataLossRisk จะกลับมาอีกแล้ว false.