Przegląd funkcji
Przegląd funkcji
Ta strona mapuje powierzchnię funkcji Aspose.Cells FOSS dla Rust. Każdy obszar łączy typy punktu wejścia, które napotkasz w API Reference.
Cykl życia skoroszytu
Workbook jest obiektem głównym: Workbook::new tworzy pusty skoroszyt, Workbook::load_xlsx otwiera istniejący plik, a save, save_xlsx lub save_with_format zapisują wyjście XLSX zarządzane przez wyliczenie SaveFormat.
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;Komórki, wartości i formuły
Zbiory komórek pochodzą z get_cells / get_cells_mut na arkuszu. Typowane settery (put_value_string, put_value_i32, put_value_bool, put_value_decimal, put_value_date_time) unikają konwersji łańcuchów, a put_formula_with_cached_value przechowuje formuły wraz z ich zbuforowanymi wynikami:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;Wykresy
Wykresy przypinają się do zakresów komórek poprzez kolekcję wykresów arkusza przy użyciu wariantów ChartType, takich jak Column i Line; przypięcia i typy można odczytać z załadowanych skoroszytów za pomocą Chart i ChartCollection.
Stylowanie i układ
CellStyle łączy Font, Fill i Borders; StyleFlag wybiera, które aspekty mają zastosowanie. NumberFormat renderuje wartości, PageSetup kontroluje PaperSizeType i PageOrientationType, a FreezePane przypina wiersze nagłówka.
Jakość danych i struktura
Validation (z OperatorType), formatowanie warunkowe FormatCondition, filtrowanie AutoFilter, strukturalne tabele ListObject z TableStyleType, nazwy zakresów DefinedName oraz WorkbookProtection / WorksheetProtection.
Obronne ładowanie
LoadOptions udostępnia flagi try_repair_package i try_repair_xml; LoadDiagnostics zgłasza problemy wykryte podczas ładowania. Błędy w całej powierzchni API używają Result z CellsError.
Wskazówki i najlepsze praktyki
- Zakres
get_worksheets_mut/get_cells_mutpożycza w bloku, aby skoroszyt mógł zostać zapisany później. - Preferuj typowane settery zamiast formatowania wartości jako ciągi znaków.
- Zawsze dostarczaj wartość w pamięci podręcznej wraz z formułami, aby pliki otwierały się z prawidłowymi wynikami przed przeliczeniem.
- Używaj flag naprawczych
LoadOptionsprzy importowaniu plików firm trzecich.
API Reference Podsumowanie
| Klasa | Opis |
|---|---|
Workbook | Obiekt główny: tworzenie, wczytywanie i zapisywanie skoroszytów XLSX |
Worksheet | Pojedynczy arkusz oraz jego komórki, wykresy i ustawienia |
CellMut | Modyfikowalna komórka: ustawianie typowanej wartości i formuły |
CellStyle | Formatowanie komórek: czcionka, wypełnienie i obramowania |
ChartType | Wybór typu wykresu podczas dodawania wykresów |
Validation | Reguły walidacji danych |
AutoFilter | Filtrowanie zakresu |
LoadOptions | Zachowanie ładowania i flagi naprawy |
CellsError | Typ błędu zwracany w API |