Как да работите с основните настройки на работната книга в .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;Стъпка 3: Конфигуриране на Настройки за работната книга
Workbook.Settings връща a WorkbookSettings Общ обект. 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) приема да 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 г.; системите за смесване причиняват грешки извън 1462 дни.
Често задавани въпроси
Каква е разликата между: WorkbookSettings и в) WorkbookProperties?
WorkbookSettings (чрез Workbook.Settings) съдържа конфигурационни стойности като: Date1904 и в) Culture. WorkbookProperties (чрез Workbook.Properties) съдържа OOXML знаци за показване като: ShowObjects. Строевете метаданни на документа (название, автор и др.) се съдържат в Workbook.DocumentProperties.
- Да, нали? CompactStyles Да премахна стилове, които ми трябват?
- Не, не съм.
CompactStylesпремахва само стилове, които не са посочени от някоя клетка или правило за формат в работната книга.
Мога ли да чета? LoadDiagnostics дори когато не се опита да го поправи?
Да, в “Компания”. Issues колекцията ще бъде празна и двете HasRepairs и в) HasDataLossRisk ще се върне. false.