Aspose.Cells FOSS
Rust에서 스프레드시트를 로드하는 방법

Rust에서 스프레드시트를 로드하는 방법

Aspose.Cells FOSS for Rust는 패키지 형식에서 직접 Excel XLSX 워크북을 로드합니다 — Microsoft Office가 필요 없습니다. 이 가이드는 Cargo를 통해 aspose-cells-foss-rust 크레이트를 설치하고, Workbook::load_xlsx으로 워크북을 로드하며, LoadOptions 복구 플래그와 LoadDiagnostics을 사용해 불완전한 파일을 처리합니다.

단계별 가이드

1단계: 패키지 설치

Cargo git 의존성으로 Cargo.toml에 크레이트를 추가합니다:

# Cargo.toml
[dependencies]
aspose-cells-foss-rust = { git = "https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Rust" }

그런 다음 프로젝트를 빌드합니다:

cargo build

2단계: 필요한 클래스 가져오기 

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

3단계: 로드할 샘플 파일 만들기

디스크에 워크북이 아직 없으면 먼저 워크북을 작성하세요:

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("Item")?;
    cells.get("B1")?.put_value_string("Quantity")?;
    cells.get("A2")?.put_value_string("Apples")?;
    cells.get("B2")?.put_value_i32(12)?;
}
workbook.save("inventory.xlsx")?;

4단계: 워크북 로드

Workbook::load_xlsx은(는) 올바르게 형식화된 XLSX 파일을 엽니다:

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

5단계: 복구 옵션을 사용하여 방어적으로 로드하기

타사 파일의 경우, 복구 플래그를 활성화하고 로더가 수집한 진단 정보를 검사하세요:

let options = LoadOptions {
    try_repair_package: true,
    try_repair_xml: true,
    ..LoadOptions::default()
};

let loaded = Workbook::load_xlsx_with_options("inventory.xlsx", &options)?;
println!(
    "Loaded workbook with {} worksheet(s) and {} diagnostic issue(s).",
    loaded.get_worksheets().count(),
    loaded.get_load_diagnostics().issues().len()
);

일반적인 문제와 해결책

로드 호출이 Excel에서 열리는 파일에 대해 오류를 반환합니다. Enable try_repair_package and try_repair_xml in LoadOptions 그리고 다음을 통해 로드합니다 Workbook::load_xlsx_with_options — Excel은 엄격한 로드가 거부하는 일부 패키지 불규칙성을 허용합니다.

worksheet("Sheet1") 로드 후 실패합니다. 시트 이름이 다를 수 있습니다. 다음을 통해 열거합니다 get_worksheets 또는 워크시트 컬렉션을 통해 인덱스로 가져옵니다.

값이 빈 문자열로 읽혀옵니다. 사용하십시오 display_string_value 셀에 표시 텍스트를 입력하고 확인 value_type 실제로 저장된 것을 확인하려면.

수식이 오래된 결과를 표시합니다. 로드기는 파일에 저장된 캐시 값을 보존합니다; 재계산은 사용자의 책임입니다. 기록할 때는 항상 올바른 캐시 값을 전달하십시오. put_formula_with_cached_value.

자주 묻는 질문

로드할 수 있는 형식은 무엇입니까?

현재 릴리스에서는 XLSX만 지원됩니다. LoadFormat 열거형은 Auto와 Xlsx를 포함합니다.

Microsoft Office를 설치해야 하나요?

아니요. 이 crate는 XLSX 패키지를 직접 파싱하므로 Office, COM 또는 외부 런타임이 필요하지 않습니다.

로더가 복구했는지 어떻게 알 수 있나요?

로드된 워크북에서 get_load_diagnostics을(를) 확인하세요 — LoadDiagnostics은 로드 중에 발생한 문제들을 나열합니다.

참조

 한국어