כיצד לעבוד עם הגדרות ספר עבודה 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 חזרה A 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 עבור קבצים שמקורם ב- Excel עם מערכת התאריך 1904 מופעלת; מערכות שילוב גורמות לשגיאות של 1462 ימים.

שאלות נפוצות

מה ההבדל בין `WorkbookSettings` ו `WorkbookProperties`?

WorkbookSettings (בדרך Workbook.Settings(האם יש ערכים של סיווג כמו: Date1904 ו Culture. WorkbookProperties (בדרך Workbook.Properties(הדף המשתמש מכיל דגלים OOXML כגון: ShowObjects.מספרי מטאנתט (Title, Author, etc.) חיו ב-Document Metadata Strings (titel, author, Workbook.DocumentProperties.

עושה `CompactStyles` האם אני מוריד את הסגנונות שאני צריך?

לא. CompactStyles מסיר רק סגנונות שאינם מתייחסים על ידי כל תאים או חוקי פורמט בספר העבודה.

אני יכול לקרוא `LoadDiagnostics` גם אם לא ניסינו לתקן.?

כן, The Issues המקום יהיה ריק ושניהם. HasRepairs ו HasDataLossRisk יחזור false.