Exceptions — Aspose.Note FOSS for Python API Reference

Importació: from aspose.note import IncorrectDocumentStructureException Hereta: AsposeNoteError

Totes les excepcions es poden importar directament des de aspose.note:

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

Llançada quan el fitxer .one no es pot analitzar perquè la seva estructura binària està corrompuda o malformada.:

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

AsposeNoteError

Example: from aspose.note import AsposeNoteError Example: Exception

Quan es llança.

from aspose.note import Document, AsposeNoteError

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

FileCorruptedException

Example: from aspose.note import FileCorruptedException Example: AsposeNoteError

Llançada quan el .one el fitxer no es pot analitzar perquè la seva estructura binària està corrompuda o malformada.

Es llança quan s’executa Document.Save() amb un SaveFormat o una classe d’opcions que no està implementada a la versió v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats llencen aquesta excepció.

• Llançada per Document.__init__ quan l’analitzador de fitxers troba un error binari irrecuperable.

Example

from aspose.note import Document, FileCorruptedException

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

IncorrectDocumentStructureException

Example: from aspose.note import IncorrectDocumentStructureException Example: AsposeNoteError

Llançada quan l’estructura del fitxer es reconeix com a .one fitxer però conté una estructura interna invàlida o no suportada.

Es llança quan s’executa Document.Save() amb un SaveFormat o una classe d’opcions que no està implementada a la versió v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats llencen aquesta excepció.

• Llançada per Document.__init__ quan el fitxer supera les comprovacions bàsiques de format però té problemes estructurals que impedeixen la càrrega.

Example

from aspose.note import Document, IncorrectDocumentStructureException

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

IncorrectPasswordException

Example: from aspose.note import IncorrectPasswordException Example: AsposeNoteError

Llançada quan LoadOptions.DocumentPassword està establert. Els documents encriptats (protegit per contrasenya) no són compatibles a la versió v26.3.1.

Es llança quan s’executa Document.Save() amb un SaveFormat o una classe d’opcions que no està implementada a la versió v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats llencen aquesta excepció.

• Llançat per Document.__init__ quan load_options.DocumentPassword no és None.

Example

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

Example: from aspose.note import UnsupportedFileFormatException Example: AsposeNoteError

Llançat quan el format del fitxer no es reconeix com a vàlid .one fitxer. Exposa un FileFormat atribut (una cadena) amb l’identificador de format detectat o intentat.

Example

Es llança quan s’executa Document.Save() amb un SaveFormat o una classe d’opcions que no està implementada a la versió v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats llencen aquesta excepció.

• Llançat per Document.__init__ quan l’analitzador no pot identificar el fitxer com a un format OneNote compatible.

Example

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

Example: from aspose.note import UnsupportedSaveFormatException Example: AsposeNoteError

Llançat quan Document.Save() es crida amb un SaveFormat o classe d’opcions que no està implementada a la v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats generen aquesta excepció.

Es llança quan s’executa Document.Save() amb un SaveFormat o una classe d’opcions que no està implementada a la versió v26.3.1. Només SaveFormat.Pdf està implementat; tots els altres formats llencen aquesta excepció.

• Document.Save(target, SaveFormat.One) — El format de viatge d’anada i torn de OneNote està declarat però no implementat
• Document.Save(target, ...) utilitzant qualsevol SaveOptions subclasse que no és PdfSaveOptions

Example

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}")

Capturant tots els errors de càrrega

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

Capturant tots els errors d’guardat

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}")

Vegeu també

• Example: el constructor genera excepcions de càrrega; Save() genera UnsupportedSaveFormatException
• LoadOptions: configuració DocumentPassword activa IncorrectPasswordException
• SaveFormat: només SaveFormat.Pdf està implementat a la v26.3.1