كيفية العمل مع إعدادات الكتاب العاشر في .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 عودة أ WorkbookSettings الموضوع : Set Date1904 = true بالنسبة للملفات الأصلية في macOS التي تستخدم نظام التاريخ 1904. 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) يوافق على A 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 تمكينها؛ أنظمة الخلط تسبب أخطاء off-by-1462 يوم.
الأسئلة المتكررة
ما الفرق بين WorkbookSettings و WorkbookProperties?
WorkbookSettings ( من خلال Workbook.Settings( ) يحتوي على قيمة التحكم مثل Date1904 و Culture. WorkbookProperties ( من خلال Workbook.Properties* يحتوي على علامات عرض OOXML مثل: ShowObjects.سلاسل البيانات الميتا (العنوان، المؤلف، إلخ) على قيد الحياة في Workbook.DocumentProperties.
يُفعل CompactStyles هل تريد إزالة النمط الذي أحتاجه؟?
لا . CompactStyles فقط إزالة الأنماط التي لا يشير إليها أي قاعدة الخلية أو النموذج في دفتر العمل.
يمكنني قراءة LoadDiagnostics حتى عندما لم يتم إجراء أي إصلاح.?
نعم، أليس كذلك؟ Issues سيتم إخفاء المجموعة و كلاهما HasRepairs و HasDataLossRisk سوف يعود false.