Wie man mit den Kern-Arbeitsmappen-Einstellungen in .NET arbeitet

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (Standort- und Datumssystem), Workbook.DocumentProperties (Metadaten des Autors), Workbook.LoadDiagnostics (Reparaturbericht) und SaveOptions (Sicherheitsverhalten) installieren mit dotnet add package Aspose.Cells_FOSS.

Schritt für Schritte

Schritt 1: Installieren des Pakets

dotnet add package Aspose.Cells_FOSS

Schritt 2: Importieren des Namensraums

using Aspose.Cells_FOSS;
using System.Globalization;

Schritt 3: Arbeitsbuch-Einstellungen konfigurieren

Workbook.Settings gibt a zurück. WorkbookSettings Objekt. Set Date1904 = true für macOS-basierte Dateien, die das Datensystem 1904 verwenden. Set Culture Um die Nummer und das Datum zu kontrollieren.

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

Schritt 4: Dokument-Eigenschaften einstellen

Workbook.DocumentProperties Auslöser Title, Subject, Author, Keywords, Comments, Category, Company,und . Manager als direkte String-Eigenschaften.

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

Schritt 5: SaveOptions verwenden

Workbook.Save(path, SaveOptions) Akzeptiert eine SaveOptions Die wichtigsten Eigenschaften: UseSharedStrings (reduziert die Dateigröße für Blätter mit wiederholten Zeichenfolgen), ValidateBeforeSave (läuft vor dem Schreiben Validierung durch) und CompactStyles (entfernt nicht verwendete Stile).

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

Schritt 6: Nach der Reparatur die Lastdiagnose lesen

Nach dem Verladen mit TryRepairPackage = true, überprüfen Workbook.LoadDiagnostics um zu sehen, ob Reparaturen durchgeführt wurden.

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

Häufige Probleme und Lösungen

WorkbookSaveException - Wann? ValidateBeforeSave = true. Das Arbeitsbuch enthält eine strukturelle Inkonsistenz. Deaktivieren ValidateBeforeSave Die Kommission hat die Möglichkeit, den Antrag auf Erteilung einer Genehmigung für eine Bewilligung zu beantworten.

Dokument-Eigenschaften nicht sichtbar im Excel-Dateiinformationsfeld. Stellen Sie sicher, dass Sie die Eigenschaften auf Workbook.DocumentProperties, nicht . Workbook.Properties.Letztere enthält Anzeigungsflaggen, nicht Metadatenfolgen.

Date1904 = true verursacht Datumswerte zu verschieben. Date1904 ändert die Epoche, die für Datum-Seriennummern verwendet wird. Setzen Sie sie nur auf true für Dateien, die aus macOS Excel stammen und das Datensystem 1904 aktiviert sind; Mischsysteme verursachen Fehler von 1462 Tagen.

Häufig gestellte Fragen

Was ist der Unterschied zwischen `WorkbookSettings` und . `WorkbookProperties`?

WorkbookSettings (über die Workbook.Settings) enthält Konfigurationswerte wie: Date1904 und . Culture. WorkbookProperties (über die Workbook.Properties) enthält OOXML-Anzeigemerkungen wie: ShowObjects.Dokument-Metadatenstrings (Titel, Autor usw.) werden in der Workbook.DocumentProperties.

Ist es so ? `CompactStyles` Ich muss die Stile entfernen.?

Nein, ich bin nicht. CompactStyles Entfernt nur Stile, auf die keine Zelle oder Formatsregel in der Arbeitsmappe verweist.

Kann ich lesen ? `LoadDiagnostics` Auch wenn keine Reparatur versucht wurde?

Ja, die… Issues Sammlung wird leer sein und beide HasRepairs und . HasDataLossRisk wird zurückkehren . false.