AttachedFile — Aspose.Note FOSS for Python API Reference

Classe : AttachedFile

Examples: aspose.note Examples: from aspose.note import AttachedFile Examples: CompositeNode

AttachedFile représente un fichier binaire qui a été intégré dans une section OneNote. C’est un enfant de OutlineElement. Les données brutes du fichier sont disponibles via le Bytes propriété ; le nom de fichier original se trouve dans FileName. Les balises OneNote attachées à la pièce jointe sont exposées via Tags.

Examples

Hérité de CompositeNode / Node

Examples

• Contenu en lecture seule: Bytes et FileName sont analysés directement à partir du binaire MS-ONE. Il n’existe aucune API pour remplacer les données de fichier intégrées dans la version 26.3.1.
• Examples: Enregistrement d’un document qui contient AttachedFile les nœuds vers PDF intègrent les métadonnées de la pièce jointe mais pas le contenu binaire dans le PDF lui‑même.
• Octets vides: Si le bloc de données du fichier est manquant ou de longueur nulle dans la source .one fichier, Bytes renvoie b"".

Exemple d’utilisation

Extraire toutes les pièces jointes sur le disque

import os
from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")
output_dir = "attachments"
os.makedirs(output_dir, exist_ok=True)

for af in doc.GetChildNodes(AttachedFile):
    name = af.FileName or "unnamed_attachment"
    dest = os.path.join(output_dir, name)
    with open(dest, "wb") as f:
        f.write(af.Bytes)
    print(f"Saved: {dest}  ({len(af.Bytes)} bytes)")

Lister les pièces jointes avec leurs balises

from aspose.note import Document, AttachedFile

doc = Document("MyNotes.one")
for af in doc.GetChildNodes(AttachedFile):
    tag_labels = [t.label for t in af.Tags if t.label]
    print(f"{af.FileName!r}  tags={tag_labels}  size={len(af.Bytes)}B")

Sécurité None

FileName peut être None; fournissez toujours un nom de secours lors de l’écriture des fichiers. Bytes est toujours bytes (jamais None), mais peut être vide (b""). Tags est toujours une liste (peut être vide).

Voir aussi

• CompositeNode: classe parente
• NoteTag: étiquettes sur une pièce jointe
• OutlineElement: conteneur pour AttachedFile
• Guide du développeur