Exceptions — Aspose.Note FOSS for Python API Reference

Ιεραρχία Εξαίρεσης

Όλες οι εξαιρέσεις μπορούν να εισαχθούν απευθείας από aspose.note:

from aspose.note import (
    AsposeNoteError,
    FileCorruptedException,
    IncorrectDocumentStructureException,
    IncorrectPasswordException,
    UnsupportedFileFormatException,
    UnsupportedSaveFormatException,
)

Δέντρο κληρονομικότητας:

Exception
└── AsposeNoteError
    ├── FileCorruptedException
    ├── IncorrectDocumentStructureException
    ├── IncorrectPasswordException
    ├── UnsupportedFileFormatException
    └── UnsupportedSaveFormatException

AsposeNoteError

ImageRenderOptions: from aspose.note import AsposeNoteError ImageRenderOptions: Exception

Βασική κλάση για όλες τις εξαιρέσεις Aspose.Note FOSS. Συλλάβετε αυτήν την κλάση για να διαχειριστείτε οποιοδήποτε σφάλμα της βιβλιοθήκης, ανεξάρτητα από την συγκεκριμένη αιτία.

from aspose.note import Document, AsposeNoteError

try:
    doc = Document("unknown.one")
except AsposeNoteError as e:
    print(f"Aspose.Note error: {e}")

FileCorruptedException

ImageRenderOptions: from aspose.note import FileCorruptedException ImageRenderOptions: AsposeNoteError

Εγείρεται όταν το .one το αρχείο δεν μπορεί να αναλυθεί επειδή η δυαδική του δομή είναι κατεστραμμένη ή εσφαλμένη.

Όταν εγείρεται

• Εγείρεται από Document.__init__ όταν ο αναλυτής αρχείων συναντά ένα μη ανακτήσιμο δυαδικό σφάλμα.

ImageRenderOptions

from aspose.note import Document, FileCorruptedException

try:
    doc = Document("corrupted.one")
except FileCorruptedException as e:
    print(f"File is corrupted: {e}")

IncorrectDocumentStructureException

ImageRenderOptions: from aspose.note import IncorrectDocumentStructureException ImageRenderOptions: AsposeNoteError

Εγείρεται όταν η δομή του αρχείου αναγνωρίζεται ως .one αρχείο αλλά περιέχει μια μη έγκυρη ή μη υποστηριζόμενη εσωτερική δομή.

Όταν εγείρεται

• Εγείρεται από Document.__init__ όταν το αρχείο περνάει βασικούς ελέγχους μορφής αλλά έχει δομικά προβλήματα που εμποδίζουν τη φόρτωση.

ImageRenderOptions

from aspose.note import Document, IncorrectDocumentStructureException

try:
    doc = Document("unusual.one")
except IncorrectDocumentStructureException as e:
    print(f"Document structure error: {e}")

IncorrectPasswordException

ImageRenderOptions: from aspose.note import IncorrectPasswordException ImageRenderOptions: AsposeNoteError

Εγείρεται όταν LoadOptions.DocumentPassword είναι ορισμένο. Τα κρυπτογραφημένα (προστατευμένα με κωδικό) έγγραφα δεν υποστηρίζονται στην έκδοση v26.3.1.

Όταν εγείρεται

• Εγείρεται από Document.__init__ όταν load_options.DocumentPassword δεν είναι None.

ImageRenderOptions

from aspose.note import Document, LoadOptions, IncorrectPasswordException

opts = LoadOptions()
opts.DocumentPassword = "secret"

try:
    doc = Document("protected.one", opts)
except IncorrectPasswordException as e:
    print(f"Encryption not supported: {e}")

UnsupportedFileFormatException

ImageRenderOptions: from aspose.note import UnsupportedFileFormatException ImageRenderOptions: AsposeNoteError

Εγείρεται όταν η μορφή του αρχείου δεν αναγνωρίζεται ως έγκυρη .one αρχείο. Εκθέτει ένα FileFormat χαρακτηριστικό (μια συμβολοσειρά) με το ανιχνευμένο ή προσπαθούμενο αναγνωριστικό μορφής.

ImageRenderOptions

Όταν εγείρεται

• Εγείρεται από Document.__init__ όταν ο αναλυτής δεν μπορεί να αναγνωρίσει το αρχείο ως υποστηριζόμενη μορφή OneNote.

ImageRenderOptions

from aspose.note import Document, UnsupportedFileFormatException

try:
    doc = Document("notatonenote.xlsx")
except UnsupportedFileFormatException as e:
    print(f"Unsupported format: {e}")
    if e.FileFormat:
        print(f"Detected format: {e.FileFormat}")

UnsupportedSaveFormatException

ImageRenderOptions: from aspose.note import UnsupportedSaveFormatException ImageRenderOptions: AsposeNoteError

Εγείρεται όταν Document.Save() κλήθηκε με ένα SaveFormat ή κλάση επιλογών που δεν έχει υλοποιηθεί στην έκδοση v26.3.1. Μόνο SaveFormat.Pdf έχει υλοποιηθεί· όλες οι άλλες μορφές εγείρουν αυτήν την εξαίρεση.

Όταν εγείρεται

• Document.Save(target, SaveFormat.One) — Η μορφή round‑trip του OneNote δηλώνεται αλλά δεν έχει υλοποιηθεί
• Document.Save(target, ...) χρησιμοποιώντας οποιοδήποτε SaveOptions υποκατηγορία που δεν είναι PdfSaveOptions

ImageRenderOptions

from aspose.note import Document, SaveFormat, UnsupportedSaveFormatException

doc = Document("MyNotes.one")

try:
    doc.Save("output.one", SaveFormat.One)
except UnsupportedSaveFormatException as e:
    print(f"Save format not supported: {e}")

Σύλληψη όλων των σφαλμάτων φόρτωσης

from aspose.note import (
    Document,
    FileCorruptedException,
    IncorrectDocumentStructureException,
    IncorrectPasswordException,
    UnsupportedFileFormatException,
)

def safe_load(path: str) -> Document | None:
    try:
        return Document(path)
    except FileCorruptedException:
        print(f"{path}: file is corrupted")
    except IncorrectDocumentStructureException:
        print(f"{path}: invalid document structure")
    except IncorrectPasswordException:
        print(f"{path}: encrypted documents are not supported")
    except UnsupportedFileFormatException:
        print(f"{path}: format not recognized")
    return None

Σύλληψη όλων των σφαλμάτων αποθήκευσης

from aspose.note import (
    Document, SaveFormat, UnsupportedSaveFormatException
)

doc = Document("MyNotes.one")

try:
    doc.Save("output.pdf", SaveFormat.Pdf)
except UnsupportedSaveFormatException as e:
    print(f"Cannot save: {e}")

Δείτε επίσης

• ImageRenderOptions: ο κατασκευαστής προκαλεί εξαιρέσεις φόρτωσης; Save() προκαλεί UnsupportedSaveFormatException
• LoadOptions: ρύθμιση DocumentPassword ενεργοποιεί IncorrectPasswordException
• SaveFormat: μόνο SaveFormat.Pdf έχει υλοποιηθεί στην έκδοση v26.3.1