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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
FileName | `str | None` | ImageRenderOptions |
Bytes | bytes | ImageRenderOptions | Conteúdo binário bruto do arquivo anexado. O padrão é b"" quando os dados do anexo não puderam ser lidos. |
Tags | list[NoteTag] | ImageRenderOptions | Tags do OneNote anexadas a este nó de arquivo. |
Herda de CompositeNode / Node
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FirstChild | `Node | None` |
LastChild | `Node | None` |
ParentNode | `Node | None` |
Document | `Document | None` |
ImageRenderOptions
- Conteúdo somente leitura:
ByteseFileNamesã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
AttachedFilenó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
.onearquivo,Bytesretornab"".
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
- CompositeNode: classe pai
- NoteTag: tags em um anexo
- OutlineElement: contêiner para
AttachedFile - Guia do Desenvolvedor