כיצד לעבוד עם הגדרות ספר עבודה Core ב .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: הגדרת 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: השתמש SaveOptions

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: קרא LoadDiagnostics לאחר תיקון

לאחר ההעלאה עם 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.