Exceptions — Aspose.Note FOSS for Python API Reference

Hiérarchie des exceptions

Toutes les exceptions sont importables directement depuis aspose.note:

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

Arbre d’héritage :

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

AsposeNoteError

Examples: from aspose.note import AsposeNoteError Examples: Exception

Classe de base pour toutes les exceptions Aspose.Note FOSS. Capturez cette classe pour gérer toute erreur de la bibliothèque, quel que soit le motif spécifique.

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

Levée lorsque le .one le fichier ne peut pas être analysé parce que sa structure binaire est corrompue ou malformée.

Lorsqu’elle est levée

• Levée par Document.__init__ lorsque l’analyseur de fichier rencontre une erreur binaire irrécupérable.

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

Levée lorsque la structure du fichier est reconnue comme un .one fichier mais contient une structure interne invalide ou non prise en charge.

Lorsqu’elle est levée

• Levée par Document.__init__ lorsque le fichier passe les vérifications de format de base mais présente des problèmes structurels qui empêchent le chargement.

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

Levée lorsque LoadOptions.DocumentPassword est défini. Les documents chiffrés (protégés par mot de passe) ne sont pas pris en charge dans la version v26.3.1.

Lorsqu’elle est levée

• Levée par Document.__init__ lorsque load_options.DocumentPassword n’est pas 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

Levée lorsque le format de fichier n’est pas reconnu comme valide .one fichier. Expose un FileFormat attribut (une chaîne) contenant l’identifiant de format détecté ou tenté.

Examples

Lorsqu’elle est levée

• Levée par Document.__init__ lorsque l’analyseur ne peut pas identifier le fichier comme un format OneNote pris en charge.

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

Levée lorsque Document.Save() est appelée avec un SaveFormat ou classe d’options qui n’est pas implémentée dans v26.3.1. Seul SaveFormat.Pdf est implémenté ; tous les autres formats lèvent cette exception.

Lorsqu’elle est levée

• Document.Save(target, SaveFormat.One) — Le format de boucle OneNote est déclaré mais non implémenté
• Document.Save(target, ...) en utilisant n’importe quel SaveOptions sous-classe qui n’est pas 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}")

Capture de toutes les erreurs de chargement

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

Capture de toutes les erreurs d’enregistrement

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

Voir aussi

• Examples: le constructeur lève des exceptions de chargement ; Save() lève UnsupportedSaveFormatException
• LoadOptions: paramètre DocumentPassword déclenche IncorrectPasswordException
• SaveFormat: uniquement SaveFormat.Pdf est implémenté dans v26.3.1