Exceptions — Aspose.Note FOSS for Python API Reference

Jerarquía de Excepciones

Todas las excepciones se pueden importar directamente desde aspose.note:

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

Árbol de herencia:

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

AsposeNoteError

Examples: from aspose.note import AsposeNoteError Examples: Exception

Clase base para todas las excepciones FOSS de Aspose.Note. Capture esta clase para manejar cualquier error de la biblioteca sin importar la causa específica.

from aspose.note import Document, AsposeNoteError

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

FileCorruptedException

Examples: from aspose.note import FileCorruptedException Examples: AsposeNoteError

Se lanza cuando el .one el archivo no se puede analizar porque su estructura binaria está corrupta o malformada.

Cuando se lanza

• Se lanza por Document.__init__ cuando el analizador de archivos encuentra un error binario irrecuperable.

Examples

from aspose.note import Document, FileCorruptedException

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

IncorrectDocumentStructureException

Examples: from aspose.note import IncorrectDocumentStructureException Examples: AsposeNoteError

Se lanza cuando la estructura del archivo se reconoce como un .one archivo pero contiene una estructura interna inválida o no soportada.

Cuando se lanza

• Se lanza por Document.__init__ cuando el archivo pasa las comprobaciones básicas de formato pero tiene problemas estructurales que impiden la carga.

Examples

from aspose.note import Document, IncorrectDocumentStructureException

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

IncorrectPasswordException

Examples: from aspose.note import IncorrectPasswordException Examples: AsposeNoteError

Se lanza cuando LoadOptions.DocumentPassword está configurado. Los documentos cifrados (protegidos con contraseña) no son compatibles en v26.3.1.

Cuando se lanza

• Generado por Document.__init__ cuando load_options.DocumentPassword no es None.

Examples

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

Examples: from aspose.note import UnsupportedFileFormatException Examples: AsposeNoteError

Generado cuando el formato de archivo no se reconoce como un válido .one archivo. Expone un FileFormat atributo (una cadena) con el identificador de formato detectado o intentado.

Examples

Cuando se lanza

• Generado por Document.__init__ cuando el analizador no puede identificar el archivo como un formato OneNote compatible.

Examples

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

Examples: from aspose.note import UnsupportedSaveFormatException Examples: AsposeNoteError

Generado cuando Document.Save() se llama con un SaveFormat o clase de opciones que no está implementada en v26.3.1. Sólo SaveFormat.Pdf está implementado; todos los demás formatos generan esta excepción.

Cuando se lanza

• Document.Save(target, SaveFormat.One) — El formato de ida y vuelta de OneNote está declarado pero no implementado
• Document.Save(target, ...) usando cualquier SaveOptions subclase que no es PdfSaveOptions

Examples

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

Capturando Todos los Errores de Carga

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

Capturando Todos los Errores de Guardado

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

Ver también

• Examples: el constructor genera excepciones de carga; Save() genera UnsupportedSaveFormatException
• LoadOptions: configuración DocumentPassword desencadena IncorrectPasswordException
• SaveFormat: solo SaveFormat.Pdf está implementado en v26.3.1