Quickstart

Quickstart

تستعرض هذه الصفحة سير عمل Aspose.Cells FOSS للـ Rust الأساسي: إنشاء Workbook، كتابة قيم خلايا typed وصيغة، حفظ الملف، وإعادة تحميله.


المتطلبات المسبقة

المتطلباتالتفاصيل
تم تثبيت الحزمةانظر Installation
سلسلة أدوات Rustالإصدار 2021

1. إنشاء Workbook وكتابة القيم

يبدأ Workbook جديد بوجود ورقة عمل واحدة تُدعى Sheet1. يتم تمرير الوصول القابل للتعديل عبر get_worksheets_mut وget_cells_mut؛ كل خلية لديها مُعَدِّلات typed:

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 — يُنشئ Workbook فارغًا بورقة واحدة.
  • put_value_string / put_value_i32 / put_value_bool / put_value_decimal — مُعيّنات الخلايا المكتوبة بالأنواع.
  • put_formula_with_cached_value — يخزن الصيغة والقيمة التي يعرضها Excel قبل إعادة الحساب.
  • Workbook::save — يكتب حزمة XLSX إلى القرص.
  • Workbook::load_xlsx — يحمل ملف XLSX موجود.
  • display_string_value — نص عرض الخلية عند قراءة القيم مرة أخرى.

3. تشغيله

cargo run

يكتب البرنامج hello.xlsx ويطبع A1 = Hello بعد إعادة تحميله.


الخطوات التالية

انظر أيضاً

 العربية