Exceptions — Aspose.Note FOSS for Python API Reference

Hierarquia de Exceções

Todas as exceções podem ser importadas diretamente de aspose.note:

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

Árvore de herança:

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

AsposeNoteError

ImageRenderOptions: from aspose.note import AsposeNoteError ImageRenderOptions: Exception

Classe base para todas as exceções FOSS Aspose.Note. Capture esta classe para tratar qualquer erro da biblioteca, independentemente da 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

ImageRenderOptions: from aspose.note import FileCorruptedException ImageRenderOptions: AsposeNoteError

Lançada quando o .one arquivo não pode ser analisado porque sua estrutura binária está corrompida ou malformada.

Quando lançada

• Lançada por Document.__init__ quando o analisador de arquivos encontra um erro binário irrecuperável.

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

Lançada quando a estrutura do arquivo é reconhecida como um .one arquivo, mas contém uma estrutura interna inválida ou não suportada.

Quando lançada

• Lançada por Document.__init__ quando o arquivo passa nas verificações básicas de formato, mas tem problemas estruturais que impedem o carregamento.

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

Lançada quando LoadOptions.DocumentPassword está definido. Documentos criptografados (protegidos por senha) não são suportados na v26.3.1.

Quando lançada

• Lançado por Document.__init__ quando load_options.DocumentPassword não é 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

Lançado quando o formato do arquivo não é reconhecido como um válido .one arquivo. Expõe um FileFormat atributo (uma string) com o identificador de formato detectado ou tentado.

ImageRenderOptions

Quando lançada

• Lançado por Document.__init__ quando o analisador não consegue identificar o arquivo como um formato OneNote suportado.

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

Lançado quando Document.Save() é chamado com um SaveFormat ou classe de opções que não está implementada no v26.3.1. Apenas SaveFormat.Pdf está implementado; todos os outros formatos geram esta exceção.

Quando lançada

• Document.Save(target, SaveFormat.One) — O formato de ida e volta do OneNote está declarado, mas não está implementado
• Document.Save(target, ...) usando qualquer SaveOptions subclasse que não é 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}")

Capturando Todos os Erros de Carregamento

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 os Erros de Salvamento

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

Veja Também

• ImageRenderOptions: o construtor gera exceções de carregamento; Save() gera UnsupportedSaveFormatException
• LoadOptions: configuração DocumentPassword dispara IncorrectPasswordException
• SaveFormat: apenas SaveFormat.Pdf está implementado no v26.3.1