AttachedFile — Aspose.Note FOSS for Python API Reference

کلاس: AttachedFile

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

AttachedFile نمایانگر یک فایل باینری است که داخل یک بخش OneNote جاسازی شده است. این یک فرزند از OutlineElement. Bytes ویژگی؛ نام فایل اصلی در FileName. برچسب‌های OneNote پیوست‌شده به پیوست از طریق Tags.

ImageRenderOptions

ارث‌بری شده از CompositeNode / Node

ImageRenderOptions

• محتوای فقط‑خواندنی: Bytes و FileName به‌صورت مستقیم از باینری MS-ONE تجزیه می‌شوند. در نسخه v26.3.1 هیچ API برای جایگزینی داده‌های فایل جاسازی‌شده وجود ندارد.
• ImageRenderOptions: ذخیره‌سازی سندی که شامل AttachedFile گره‌ها به PDF، فراداده پیوست را جاسازی می‌کند اما محتوای باینری را در خود PDF قرار نمی‌دهد.
• بایت‌های خالی: اگر بلوک داده‌های فایل در منبع گم شده یا طول صفر داشته باشد .one فایل،, Bytes بازمی‌گرداند b"".

مثال استفاده

استخراج تمام پیوست‌ها به دیسک

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

فهرست‌کردن پیوست‌ها همراه با برچسب‌هایشان

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

ایمنی در برابر None

FileName ممکن است None; همیشه هنگام نوشتن فایل‌ها یک نام جایگزین ارائه دهید. Bytes همیشه است bytes (هرگز None), اما ممکن است خالی باشد (b""). Tags همیشه یک لیست است (ممکن است خالی باشد).

همچنین ببینید

• CompositeNode: کلاس والد
• NoteTag: برچسب‌ها روی یک پیوست
• OutlineElement: مخزن برای AttachedFile
• راهنمای توسعه‌دهنده