AttachedFile — Aspose.Note FOSS for Python API Reference

Classe: AttachedFile

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

AttachedFile representa um arquivo binário que foi incorporado dentro de uma seção do OneNote. É um filho de OutlineElement. Os dados brutos do arquivo estão disponíveis através do Bytes propriedade; o nome original do arquivo está em FileName. As tags do OneNote anexadas ao anexo são expostas via Tags.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`ImageRenderOptions
BytesbytesImageRenderOptionsConteúdo binário bruto do arquivo anexado. O padrão é b"" quando os dados do anexo não puderam ser lidos.
Tagslist[NoteTag]ImageRenderOptionsTags do OneNote anexadas a este nó de arquivo.

Herda de CompositeNode / Node

ImageRenderOptionsImageRenderOptionsImageRenderOptions
FirstChild`NodeNone`
LastChild`NodeNone`
ParentNode`NodeNone`
Document`DocumentNone`

ImageRenderOptions

  • Conteúdo somente leitura: Bytes e FileName são analisados diretamente do binário MS-ONE. Não há API para substituir os dados de arquivo incorporados na v26.3.1.
  • ImageRenderOptions: Salvar um documento que contém AttachedFile nós para PDF incorpora os metadados do anexo, mas não o conteúdo binário no próprio PDF.
  • Bytes vazios: Se o bloco de dados do arquivo estiver ausente ou com comprimento zero na fonte .one arquivo, Bytes retorna b"".

Exemplo de Uso

Extrair todos os anexos para o disco

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

Listar anexos com suas tags

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

Segurança contra None

FileName pode ser None; sempre forneça um nome de fallback ao gravar arquivos. Bytes é sempre bytes (nunca None), mas pode estar vazio (b""). Tags é sempre uma lista (pode estar vazia).


Veja Também

 Português