مروری بر ویژگی‌ها

نمای کلی ویژگی‌ها

این صفحه سطح ویژگی‌های Aspose.Cells FOSS برای Rust را نقشه‌برداری می‌کند. هر بخش به انواع نقطه‌ورودی که در آن‌ها ملاقات خواهید کرد، لینک می‌دهد. API Reference.

دوره‌زندگی کتاب‌کار

Workbook شیء ریشه است: Workbook::new یک کتاب‌کار خالی ایجاد می‌کند، Workbook::load_xlsx یک فایل موجود را باز می‌کند، و save، save_xlsx یا save_with_format خروجی XLSX را که توسط enum SaveFormat کنترل می‌شود، می‌نویسند.

let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;

سلول‌ها، مقادیر و فرمول‌ها

مجموعه‌های سلول از get_cells / get_cells_mut در یک برگه کاری می‌آیند. تنظیم‌کننده‌های نوعی (put_value_string، put_value_i32، put_value_bool، put_value_decimal، put_value_date_time) از تبدیل رشته‌ای جلوگیری می‌کنند، و put_formula_with_cached_value فرمول‌ها را همراه با نتایج کش‌شدهٔ آن‌ها ذخیره می‌کند:

cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
    .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;

نمودارها

نمودارها به بازه‌های سلولی از طریق مجموعه نمودارهای یک شیت با انواع ChartType مانند Column و Line متصل می‌شوند؛ انکرها و انواع می‌توانند از کتاب‌کارهای بارگذاری‌شده از طریق Chart و ChartCollection خوانده شوند.

قالب‌بندی و چیدمان

CellStyle ترکیب می‌کند Font، Fill و Borders؛ StyleFlag تعیین می‌کند کدام جنبه‌ها اعمال شوند. NumberFormat مقادیر را رندر می‌کند، PageSetup PaperSizeType و PageOrientationType را کنترل می‌کند، و FreezePane سطرهای سرصفحه را ثابت می‌کند.

کیفیت داده و ساختار

Validation (با OperatorType)، قالب‌بندی شرطی FormatCondition، فیلتر کردن AutoFilter، جداول ساختاریافته با TableStyleType در ListObject، بازه‌های نام‌دار DefinedName، و WorkbookProtection / WorksheetProtection.

بارگذاری دفاعی

LoadOptions پرچم‌های try_repair_package و try_repair_xml را آشکار می‌کند؛ LoadDiagnostics مشکلات یافت‌شده هنگام بارگذاری را گزارش می‌دهد. خطاهای موجود در سطح API با استفاده از Result به همراه CellsError به کار می‌روند.

نکات و بهترین تمرین‌ها

• محدوده get_worksheets_mut / get_cells_mut در یک بلوک قرض می‌گیرد تا پس از آن دفتر کار قابل ذخیره باشد.
• ترجیحاً از تنظیم‌کننده‌های تایپ‌شده به جای قالب‌بندی مقادیر به رشته‌ها استفاده کنید.
• همیشه یک مقدار کش‌شده همراه با فرمول‌ها فراهم کنید تا فایل‌ها قبل از بازمحاسبه با نتایج صحیح باز شوند.
• هنگام وارد کردن فایل‌های شخص ثالث از پرچم‌های تعمیر LoadOptions استفاده کنید.

API Reference خلاصه

همچنین ببینید:

• Aspose.Cells — Enterprise Documentation