Quickstart
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 بعد إعادة تحميله.