Как да работите с основните настройки на работната книга в .NET

Как да работите с основните настройки на работната книга в .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.

Вижте също:

 Български