.NET'te Core Workbook Ayarlarıyla Çalışma

Aspose.Cells FOSS for .NET, çalışma kitabı düzeyinde yapılandırmayı Workbook.Settings (yerel ayar ve tarih sistemi), Workbook.DocumentProperties (yazar meta verileri), Workbook.LoadDiagnostics (onarım raporu) ve SaveOptions (kaydetme davranışı) aracılığıyla sunar. dotnet add package Aspose.Cells_FOSS ile kurun.

Adım Adım Kılavuz

Adım 1: Paketi Yükleyin

dotnet add package Aspose.Cells_FOSS

Adım 2: Ad alanını içe aktar

using Aspose.Cells_FOSS;
using System.Globalization;

Adım 3: WorkbookSettings’i Yapılandırın

Workbook.Settings bir WorkbookSettings nesnesi döndürür. 1904 tarih sistemini kullanan macOS kaynaklı dosyalar için Date1904 = true ayarlayın. Sayı ve tarih ayrıştırma yerel ayarını kontrol etmek için Culture ayarlayın.

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

Adım 4: Belge Özelliklerini Ayarla

Workbook.DocumentProperties, Title, Subject, Author, Keywords, Comments, Category, Company ve Manager öğelerini doğrudan dize özellikleri olarak ortaya çıkarır.

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

Adım 5: SaveOptions Kullan

Workbook.Save(path, SaveOptions) çıktıyı özelleştirmek için bir SaveOptions nesnesi kabul eder. Ana özellikler: UseSharedStrings (tekrarlanan dizelere sahip sayfalar için dosya boyutunu azaltır), ValidateBeforeSave (yazmadan önce doğrulamayı çalıştırır) ve CompactStyles (kullanılmayan stilleri kaldırır).

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

Adım 6: Onarım Sonrası LoadDiagnostics’ı Oku

TryRepairPackage = true ile yükledikten sonra, herhangi bir onarımın uygulanıp uygulanmadığını görmek için Workbook.LoadDiagnostics‘yi kontrol edin.

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

Yaygın Sorunlar ve Çözümler

WorkbookSaveException ValidateBeforeSave = true olduğunda. Çalışma kitabı yapısal bir tutarsızlık içeriyor. ValidateBeforeSave‘yi geçici olarak devre dışı bırakın, dosyayı kaydedip inceleyin, ardından sorunlu içeriği düzeltin.

Excel’in Dosya Bilgileri panelinde belge özellikleri görünmüyor.
Workbook.DocumentProperties üzerinde özellikleri ayarladığınızdan emin olun, Workbook.Properties değil. İkincisi görüntüleme bayraklarını tutar, meta veri dizelerini tutmaz.

Date1904 = true tarih değerlerinin kaymasına neden olur.
Date1904 tarih seri numaraları için kullanılan epok’u değiştirir. Yalnızca macOS Excel’den 1904 tarih sistemi etkinleştirilmiş dosyalar için true olarak ayarlayın; sistemleri karıştırmak 1462 günlük hatalara yol açar.

Sıkça Sorulan Sorular

`WorkbookSettings` ile `WorkbookProperties` arasındaki fark nedir?

WorkbookSettings (Workbook.Settings aracılığıyla) Date1904 ve Culture gibi yapılandırma değerlerini tutar. WorkbookProperties (Workbook.Properties aracılığıyla) ShowObjects gibi OOXML görüntüleme bayraklarını tutar. Belge meta veri dizeleri (Başlık, Yazar, vb.) Workbook.DocumentProperties içinde bulunur.

`CompactStyles` hiç ihtiyacım olan stilleri kaldırır mı?

Hayır. CompactStyles yalnızca çalışma kitabındaki herhangi bir hücre veya biçim kuralı tarafından başvurulmayan stilleri kaldırır.

Tamir denemesi yapılmadığında bile `LoadDiagnostics` okuyabilir miyim?

Evet. Issues koleksiyonu boş olacak ve hem HasRepairs hem de HasDataLossRisk false döndürecek.