چگونه با تنظیمات کتاب کار هسته ای در .NET کار کنیم

Aspose.Cells FOSS for .NET exposes workbook-level configuration through Workbook.Settings (تاریخ و تاریخ), Workbook.DocumentProperties (تصویر متا ), Workbook.LoadDiagnostics (تصویب گزارش) و SaveOptions (تصمیم گیری) نصب با dotnet add package Aspose.Cells_FOSS.

راهنمای گام به گام

مرحله اول: نصب بسته بندی

dotnet add package Aspose.Cells_FOSS

مرحله دوم: واردات نام

using Aspose.Cells_FOSS;
using System.Globalization;

مرحله سوم: تنظیمات WorkbookSettings

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

مرحله چهارم: تنظیم ویژگی های سند

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: گزینه های ذخیره سازی را استفاده کنید.

Workbook.Save(path, SaveOptions) پذیرفته شده A SaveOptions برای ایجاد یک محصول مناسب، ویژگی های کلیدی: UseSharedStrings (تغییرمسیر در صورت تکرار، برای تعداد مجدد), ValidateBeforeSave (پیش از نوشتن، به صورت رسمی و… CompactStyles (نمایش سبک های غیر قابل استفاده).

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` برای دیدن اینکه آیا اصلاحات انجام شده است.

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

<button class=“hextra-code-copy-btn hx-group/copybtn hx-transition-all active:hx-opacity-50 hx-bg-primary-700/5 hx-border hx-border-black/5 hx-text-gray-600 hover:hx-text-gray-900 hx-rounded-md hx-p-1.5 dark:hx-bg-primary-300/10 dark:hx-border-white/10 dark:hx-text-gray-400 dark:hover:hx-text-gray-50” title=“کپی کد”

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

مشکلات و اصلاحات مشترک

WorkbookSaveException زمانی که ValidateBeforeSave = true. کتاب کار شامل یک عدم سازگاری ساختاری است. ValidateBeforeSave به طور موقت برای ذخیره و بررسی فایل، سپس محتوای مشکل را اصلاح کنید.

ویژگی های اسناد در پانل اطلاعات فایل Excel قابل مشاهده نیست. اطمینان حاصل کنید که شما در حال نصب اموال بر روی Workbook.DocumentProperties,نه، نه Workbook.Properties.این پرچم ها را در اختیار دارد، نه خطوط متا داده.

Date1904 = true به این ترتیب ارزش های تاریخ تغییر می کند. Date1904 تغییر زمان مورد استفاده برای تاریخ شماره های سریال. فقط آن را به true برای فایل هایی که از macOS Excel با سیستم تاریخ 1904 فعال شده اند؛ سیستم های مخلوط باعث اشتباهات روزهای خارج می شوند.

پرسش های متداول

تفاوت بین چه چیزی است؟ `WorkbookSettings` و `WorkbookProperties`?

WorkbookSettings ( از طریق Workbook.Settings(مطالعه ای از ارزش های تنظیمات مانند Date1904 و Culture. WorkbookProperties ( از طریق Workbook.Properties* پرچم های نمایش OOXML مانند: ShowObjects. سند متادان خطوط (نویسنده، نویسنده و غیره) زنده در Workbook.DocumentProperties.

Does `CompactStyles` آیا تا به حال سبک هایی را که نیاز دارم حذف کرده اید؟?

نه . CompactStyles فقط سبک هایی را که توسط هیچ قاعده سلولی یا فرمت در دفتر کار ذکر نشده است، حذف می کند.

می توانم بخوانم `LoadDiagnostics` حتی اگر هیچ اصلاحی انجام نشود.?

بله، این Issues این مجموعه خالی خواهد بود و هر دو HasRepairs و HasDataLossRisk بازگشت خواهد شد false.