كيفية العمل مع إعدادات الكتاب العاشر في .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: استيراد اسم الفضاء
using Aspose.Cells_FOSS;
using System.Globalization;الخطوة الثالثة: إعداد WorkbookSettings
Workbook.Settings يعيد a WorkbookSettings المادة. Date1904 = true لملفات ماكوس التي تستخدم نظام التاريخ 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: إعداد خصائص المستندات
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: استخدم الخيارات التخزينية
Workbook.Save(path, SaveOptions) يقبل بـ SaveOptions تعديل المخرجات. خصائص رئيسية: UseSharedStrings (يقلل حجم الملفات للورق مع سلسلة متكررة) ،, ValidateBeforeSave (يتم التحقق من صحة قبل الكتابة) ، و CompactStyles (تزيل الأنماط غير المستخدمة).
using Aspose.Cells_FOSS;
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: اقرأ التحليل بعد إصلاح
بعد التحميل مع TryRepairPackage = true, التحقق Workbook.LoadDiagnostics لمعرفة ما إذا كان هناك أي إصلاحات تم إجراؤها.
using Aspose.Cells_FOSS;
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}");مشكلات و تصحيحات مشتركة
WorkbookSaveException متى ؟ ValidateBeforeSave = true. الكتيب يحتوي على تناقض هيكلي. تعطيل 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.
هل هو كذلك؟ CompactStyles هل قمت بإزالة الأزياء التي أحتاجها؟?
لا، أنا… CompactStyles يزيل فقط الأساليب التي لا تشير إليها أي خلية أو قاعدة تصميم في دفتر العمل.
هل يمكنني القراءة ؟ LoadDiagnostics حتى عندما لم يتم محاولة إصلاحه؟?
نعم، الموقع. Issues سوف تكون المجموعة فارغة وكلاهما HasRepairs و HasDataLossRisk سوف يعودون false.