Core Workbook Ayarlarıyla .NET içinde Nasıl Çalışılır
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 ortaya koyar. Tek bir dotnet add package komutuyla kurun.
Adım Adım Kılavuz
Adım 1: Paketi Kurun
dotnet add package Aspose.Cells.FOSSAdım 2: Ad alanını içe aktarın
using Aspose.Cells_FOSS;
using System.Globalization;Adım 3: WorkbookSettings yapılandırın
Workbook.Settings bir WorkbookSettings nesnesi döndürür. macOS kaynaklı ve 1904 tarih sistemini kullanan dosyalar için Date1904 = true ayarlayın. Sayı ve tarih ayrıştırma bölgesini 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 string özellikleri olarak sunar.
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ğrulama yapar) 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 Okuma
TryRepairPackage = true ile yüklendikten sonra, herhangi bir onarım uygulanıp uygulanmadığını görmek için Workbook.LoadDiagnostics‘i 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}");Ortak Sorunlar ve Çözümler
WorkbookSaveException when ValidateBeforeSave = true. Çalışma kitabı yapısal bir tutarsızlık içeriyor. Devre dışı bırak ValidateBeforeSave geçici olarak dosyayı kaydetmek ve incelemek için, ardından sorunlu içeriği düzeltin.
Belge özellikleri Excel’in Dosya Bilgisi panelinde görünmüyor. Özellikleri şunun üzerine ayarladığınızdan emin olun Workbook.DocumentProperties, değil Workbook.Properties. İkincisi görüntüleme bayraklarını tutar, meta veri dizelerini değil.
Date1904 = true tarih değerlerinin kaymasına neden olur. Date1904, tarih seri numaraları için kullanılan epoku değiştirir. Yalnızca şuna ayarlayın true macOS Excel’de 1904 tarih sistemi etkinleştirilmiş dosyalar için; sistemlerin karıştırılması 1462 günlük sapma hatalarına 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ü bayraklarını tutar. Belge meta veri dizeleri (Başlık, Yazar vb.) Workbook.DocumentProperties‘de bulunur.
CompactStyles ihtiyaç duyduğum stilleri hiç kaldırır mı?
Hayır. CompactStyles yalnızca çalışma kitabındaki hiçbir hücre veya biçim kuralı tarafından başvurulmayan stilleri kaldırır.
Hiç bir onarım denenmemiş olsa bile LoadDiagnostics dosyasını okuyabilir miyim?
Evet. Issues koleksiyonu boş olacak ve HasRepairs ile HasDataLossRisk ikisi de false döndürecek.