Jak pracować z ustawieniami podstawowego księgi roboczej w .NET
Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (system lokalny i datowy), Workbook.DocumentProperties (w oparciu o metody), Workbook.LoadDiagnostics (Raport naprawy) oraz SaveOptions (zacznij od instalacji) Instalacja z dotnet add package Aspose.Cells_FOSS.
Przewodnik krok po kroku
Krok 1: Instalacja pakietu
dotnet add package Aspose.Cells_FOSSKrok 2: Importowanie nazwiska
using Aspose.Cells_FOSS;
using System.Globalization;Krok 3: Konfiguracja WorkbookSettings
Workbook.Settings Powrót A WorkbookSettings Obiekty - Set Date1904 = true dla plików pochodzących z systemu macOS, które korzystają z systemu daty 1904. Culture do kontrolowania numerów i daty lokalne parsing.
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);Krok 4: Zestaw właściwości dokumentu
Workbook.DocumentProperties Ekspozycje Title, Subject, Author, Keywords, Comments, Category, Company,i Manager jako właściwości bezpośredniego łańcucha.
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);Krok 5: Użyj opcji SaveOptions
Workbook.Save(path, SaveOptions) akceptuje A SaveOptions Zastosowanie do zbiorów. kluczowe właściwości: UseSharedStrings (zredukuje rozmiar pliku dla arkuszy z powtarzającymi się strunami), ValidateBeforeSave (wstęp do pisania) i CompactStyles (Wyłączenie nieużywanych stylów).
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.");Krok 6: Czytaj Diagnoza ładowania po naprawie
Po ładowaniu z TryRepairPackage = true, sprawdź Workbook.LoadDiagnostics Sprawdź, czy zastosowano jakieś naprawy.
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}");Wspólne problemy i rozwiązania
WorkbookSaveException Kiedy ValidateBeforeSave = true. Książka zawiera nieprawidłowości strukturalne. ValidateBeforeSave do czasu, aby zapisać i sprawdzić plik, a następnie naprawić problematyczne treści.
Właściwości dokumentu nie są widoczne w panelu Info pliku programu Excel. Upewnij się, że masz własność na Workbook.DocumentProperties,Nie Workbook.Properties.Ten trzeci posiada flagi wyświetlania, a nie metadane.
Date1904 = true Wartości daty mogą się zmieniać. Data1904 zmienia okres używany do numerów serialnych dat. true dla plików pochodzących z programu macOS Excel z systemem daty 1904 jest włączony; systemy mieszania powodują błędy na 1462 dni.
Często zadawane pytania
Jaka jest różnica między WorkbookSettings i WorkbookProperties?
WorkbookSettings (w drodze Workbook.Settings• posiada wartości konfiguracji, takie jak Date1904 i Culture. WorkbookProperties (w drodze Workbook.Properties* posiada flagę OOXML, taką jak: ShowObjects. dokument metadane struny (tytuł, autor itp.) w żywo w Workbook.DocumentProperties.
Czyli CompactStyles Czy kiedykolwiek usunąć styl, którymi potrzebuję?
Nie . CompactStyles Usuwa tylko style, które nie są odwoływane przez żadną zasadę komórki lub formatu w podręczniku.
Czytam mogę LoadDiagnostics Nawet jeśli nie próbował się naprawy.?
Tak, to jest Issues Zbiór będzie pusty i obie HasRepairs i HasDataLossRisk Powróci false.