Aspose.Cells FOSS
Python
Fehlerbehebungsanleitungen

Fehlerbehebungsanleitungen

Häufige Probleme

Dieser Abschnitt behandelt häufige Probleme beim Einsatz von Aspose.Cells FOSS in Python, insbesondere mit Klassen der API-Oberfläche wie Cell, AutoFilter, CSVHandler und CFBReader.

CSV-Import schlägt mit Kodierungsfehlern fehl

Symptome umfassen korrumpierter Text oder UnicodeDecodeError beim Laden von CSV-Dateien. Dies tritt auf, wenn die CSV-Datei eine Nicht-UTF-8-Kodierung verwendet (z. B. cp1252 oder Shift-JIS). Zur Behebung konvertieren Sie die Datei vor dem Laden in UTF-8 oder übergeben Sie eine CSVLoadOptions-Instanz an CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)

AutoFilter Nach dem Laden von XLSX nicht angewendet

Symptome umfassen fehlende Filtersteuerelemente oder ungefilterte Daten nach dem Laden einer .xlsx-Datei. Dies geschieht, wenn AutoFilterXMLLoader.load_auto_filter() wegen fehlerhaftem XML in der Quelldatei lautlos fehlschlägt. Überprüfen Sie, ob die XLSX-Datei xl/autofilters/autofilter*.xml wohlgeformt ist. Wenn die Datei extern erstellt wurde, stellen Sie sicher, dass sie ECMA-376 entspricht. Verwenden Sie AutoFilter.range, filter_columns und sort_state, um den geladenen Zustand nach dem Laden zu prüfen.

Verschlüsselte XLSX-Dateien können nicht gelesen werden

Symptome umfassen NotImplementedError: Standard encryption is not yet supported beim Versuch, eine verschlüsselte .xlsx-Datei zu öffnen. Aspose.Cells FOSS unterstützt nur Agile-Verschlüsselung (ECMA-376 Teil 2, Abschnitt 4) über AgileEncryptionParameters. Dateien, die mit Legacy-XOR oder Standard-ECMA-376-Verschlüsselung verschlüsselt sind, werden nicht unterstützt. Verwenden Sie CFBReader.read_encryption_info() nur, wenn die Datei Agile-Verschlüsselung verwendet; andernfalls entschlüsseln Sie extern vor dem Laden.

Cell-Werte werden aus XML nicht korrekt geparst

Symptome umfassen falsche Datumswerte, numerische Zeichenketten, die fälschlicherweise als Zahlen interpretiert werden, oder Fehlerwerte (z. B. #N/A), die nicht erkannt werden. Dies tritt auf, wenn CellValueHandler.parse_value_from_xml() mit falschem cell_type oder fehlendem shared_strings-Kontext verwendet wird. Stellen Sie sicher, dass cell_type dem ECMA-376-t-Attribut entspricht (z. B. 's' für gemeinsame Zeichenkette, 'n' für Zahl), und geben Sie eine befüllte shared_strings-Liste für Zeichenkettentypen an. Verwenden Sie CellValueHandler.get_cell_type(), um abgeleitete Typen vor dem Parsing zu validieren.

Fehlermeldungen

Aspose.Cells FOSS löst spezifische Fehler während Datei-E/A-, Verschlüsselungs- und Parsing-Vorgängen aus. Dieser Abschnitt dokumentiert häufige Fehlermeldungen aus Klassen wie CFBReader, CFBWriter und AutoFilterXMLLoader, zusammen mit deren Ursachen und Korrekturen.

FehlerUrsacheKorrektur
NotImplementedError: Standard encryption is not yet supportedVersuch, eine verschlüsselte XLSX mit Nicht-Agile-Verschlüsselung (z. B. XOR, RC4) zu lesen oder zu schreiben.Verwenden Sie AgileEncryptionParameters und stellen Sie sicher, dass die Datei Agile-Verschlüsselung verwendet (ECMA-376 Teil 2, Abschnitt 4).
NotImplementedError: Only Agile encryption is currently supportedVerwendung von CFBWriter oder CFBReader mit anderen Verschlüsselungsparametern als Agile.Konfigurieren Sie die Verschlüsselung über AgileEncryptionParameters, bevor Sie write() oder read_encrypted_package() aufrufen.
NotImplementedError: Unsupported chart type for creationErstellung eines Diagramms eines Typs, der nicht in ChartType.LINE, BAR, PIE, AREA oder STOCK enthalten ist.Beschränken Sie die Diagrammerstellung auf unterstützte Typen: LINE, BAR, PIE, AREA, STOCK.
NotImplementedError: Only line, bar, pie, area and stock charts are currently supportedSpeichern von nicht unterstützten Diagrammtypen (z. B. WATERFALL, BOX_WHISKER) in XML.Verwenden Sie nur unterstützte ChartType-Werte beim Speichern von Diagrammen über xml_chart_saver.
ValueError: Invalid CSV contentFehlerhafte CSV-Daten an CSVHandler.load_csv_from_string() oder load_csv() übergeben.Validieren Sie die CSV-Syntax vor dem Laden.
ValueError: Cell value type mismatchÜbergabe eines inkompatiblen Typs an CellValueHandler.format_value_for_xml() oder parse_value_from_xml().Verwenden Sie CellValueHandler.get_cell_type(), um den richtigen Zelltyp vor der Formatierung oder dem Parsing zu bestimmen.

Hilfe erhalten

Für Aspose.Cells FOSS melden Sie Probleme oder fordern Sie Funktionen über GitHub-Probleme an. Überprüfen Sie die Dokumentation für Klassen wie AutoFilter, Cell, CSVHandler und AgileEncryptionParameters. Beteiligen Sie sich an der Community in GitHub-Diskussionen für allgemeine Fragen zur Verwendung der Bibliothek in Python-Workflows.

Siehe auch

Für verwandte Anleitungen zur Behandlung häufiger Probleme in Aspose.Cells FOSS lesen Sie die Dokumentation für Kernklassen wie Cell, AutoFilter, CSVHandler und AgileEncryptionParameters.

 Deutsch