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

Example: from aspose.note import AsposeNoteError Example: 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

Example: from aspose.note import FileCorruptedException Example: AsposeNoteError

Повдига се, когато .one файлът не може да бъде анализиран, защото неговата бинарна структура е повредена или деформирана.

Когато се повдигне

• Повдига се от Document.__init__ когато парсерът на файла срещне невъзстановима бинарна грешка.

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

Повдига се, когато файловата структура се разпознае като .one файл, но съдържа невалидна или неподдържана вътрешна структура.

Когато се повдигне

• Повдига се от Document.__init__ когато файлът преминава базовите проверки за формат, но има структурни проблеми, които пречат на зареждането.

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

Възниква, когато LoadOptions.DocumentPassword е зададено. Криптираните (защитени с парола) документи не се поддържат във версия v26.3.1.

Когато се повдигне

• Възниква от Document.__init__ когато load_options.DocumentPassword не е 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

Възниква, когато файловият формат не се разпознава като валиден .one файл. Разкрива a FileFormat атрибут (низ) с открития или опитания идентификатор на формата.

Example

Когато се повдигне

• Повдигнато от Document.__init__ когато парсерът не може да идентифицира файла като поддържан OneNote формат.

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

Повдигнато когато Document.Save() се извика с SaveFormat или клас за опции, който не е имплементиран във v26.3.1. Само SaveFormat.Pdf е имплементирано; всички останали формати повдигат това изключение.

Когато се повдигне

• Document.Save(target, SaveFormat.One) — Форматът за двупосочно предаване на OneNote е деклариран, но не е реализиран
• Document.Save(target, ...) използвайки какъвто и да е SaveOptions подклас, който не е 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}")

Улавяне на всички грешки при зареждане

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

Вижте също

• Example: конструкторът предизвиква изключения при зареждане; Save() вдига UnsupportedSaveFormatException
• LoadOptions: настройка DocumentPassword задейства IncorrectPasswordException
• SaveFormat: само SaveFormat.Pdf е реализирано в v26.3.1