Quickstart

Quickstart

این صفحه جریان کار اصلی Aspose.Cells FOSS برای Rust را قدم به قدم نشان می‌دهد: ایجاد یک کتاب‌کار، نوشتن مقادیر سلولی با نوع-مشخص و یک فرمول، ذخیره‌سازی فایل و بارگذاری مجدد آن.


پیش‌نیازها

نیازمندیجزئیات
crate نصب شدهمشاهده کنید Installation
زنجیره ابزار Rustنسخه 2021

1. ایجاد یک کتاب‌کار و نوشتن مقادیر

یک Workbook جدید با یک صفحه‌کار به نام Sheet1 شروع می‌شود. دسترسی قابل تغییر از طریق get_worksheets_mut و get_cells_mut جریان دارد؛ هر سلول دارای setterهای تایپ‌شده است:

use aspose_cells_foss_rust::{CellValue, Workbook};
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    let mut workbook = Workbook::new();
    {
        let mut worksheets = workbook.get_worksheets_mut();
        let sheet = worksheets.get(0)?;
        let mut cells = sheet.get_cells_mut();

        cells.get("A1")?.put_value_string("Hello")?;
        cells.get("B1")?.put_value_i32(123)?;
        cells.get("C1")?.put_value_bool(true)?;
        cells.get("D1")?.put_value_decimal(12.5)?;
        cells.get("F1")?.put_value_i32(10)?;
        cells.get("G1")?
            .put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;
    }
    workbook.save("hello.xlsx")?;

    let loaded = Workbook::load_xlsx("hello.xlsx")?;
    let sheet = loaded.worksheet("Sheet1")?;
    let cells = sheet.get_cells();
    println!("A1 = {}", cells.get("A1")?.display_string_value());

    Ok(())
}

2. درک فراخوانی‌های کلیدی

  • Workbook::new — یک کتاب‌کار خالی با یک صفحه ایجاد می‌کند.
  • put_value_string / put_value_i32 / put_value_bool / put_value_decimal — تنظیم‌کننده‌های سلول تایپی.
  • put_formula_with_cached_value — فرمول و مقداری که اکسل قبل از محاسبه مجدد نشان می‌دهد را ذخیره می‌کند.
  • Workbook::save — بسته XLSX را روی دیسک می‌نویسد.
  • Workbook::load_xlsx — یک فایل XLSX موجود را بارگذاری می‌کند.
  • display_string_value — متن نمایش سلول هنگام خواندن مقادیر بازگشت.

۳. اجرا کنید

cargo run

برنامه hello.xlsx را می‌نویسد و پس از بارگذاری دوباره، A1 = Hello را چاپ می‌کند.


گام‌های بعدی

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

 فارسی