Attachments

Ez az oldal a fájlok PDF-be ágyazását tárgyalja. Két különböző mechanizmus létezik: dokumentumszintű mellékletek, amelyek láthatatlanul vannak beágyazva a fájlok, és oldalon rögzített fájl-melléklet annotációk, amelyek egy kattintható ikont helyeznek el egy adott oldalon.

Dokumentumszintű mellékletek

Document.AddAttachment() beágyazza a bytes egy name alá, és frissíti azt a dokumentum beágyazott fájl névfa-jában – ugyanazzal a névvel való újra hozzáadás felülírja a meglévő bejegyzést. Egy Attachment kezelőt ad vissza. A Document.GetAttachments() minden dokumentumszintű mellékletet egy Attachment kezelőket tartalmazó tömbként ad vissza, név szerint rendezve, és a Document.RemoveAttachment() nevével eltávolít egyet.

A Attachment kezelő Name, Description, MimeType, Size, CreationDate és ModDate tulajdonságként teszi elérhetővé, GetBytes() a beágyazott fájl nyers tartalmának visszaolvasásához, valamint GetField() / SetField() / RemoveField() az egyes /Filespec mezők alacsonyabb szintű eléréséhez. Az opcionális AttachmentOptions, amelyet a AddAttachment() kap, elfogadja a mimeType, description, compress, creationDate és modDate értékeket.

Jelenleg nincs ellenőrzött kódrészlet ehhez a API számára ebben a platformra vonatkozó tudáspillanatképben – lásd alább a API Reference összefoglalót a pontos módszer- és tulajdonnévértékekért.

Oldalon rögzített fájl-mellékletek

Page.AddFileAttachment() egy fájlt ágyaz be, és egy /FileAttachment ikon annotációt helyez el egy adott rect egy konkrét oldalon, és visszaad egy FileAttachmentAnnotation. A dokumentumszintű csatolással ellentétben ez látható és kattintható egy PDF-megjelenítőben. FileAttachmentAnnotation megosztja a közös annotációs tulajdonságokat (Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity) plusz a saját Icon és FileName, és támogatja a GetBytes() a beágyazott tartalom olvasásához és a Flatten() az ikon statikus oldal tartalommá történő beégetéséhez.

Tippek és legjobb gyakorlatok

Használjon dokumentumszintű csatolást (Document.AddAttachment()) egy olyan fájlhoz, amelynek a PDF-vel együtt kell utaznia anélkül, hogy megjelenne bármely oldalon; használja a Page.AddFileAttachment()-t, amikor a fájlt egy kattintható ikonként kell megjeleníteni egy adott helyen.
Document.AddAttachment() felülír egy meglévő csatolást ugyanazzal a name — ellenőrizze először a Document.GetAttachments(), ha el szeretné kerülni a véletlen helyettesítést.
Olvassa vissza egy csatolás tartalmát a GetBytes() segítségével bármely fogantyú típuson — a módszer mind a Attachment, mind a FileAttachmentAnnotation esetén elérhető.

Gyakori problémák

Probléma	Oka	Javítás
Egy újonnan hozzáadott melléklet felülírta a meglévőt	`Document.AddAttachment()` már egy használatban lévő `name` esetén lett meghívva	Először hívd meg a(z) `Document.GetAttachments()` függvényt, hogy ellenőrizd a névütközést
A mellékletnek nincs látható ikonja az oldalon	`Document.AddAttachment()` lett használva, amely dokumentumszintű, és tervezés szerint nincs oldalra vonatkozó jelenléte	Használja a `Page.AddFileAttachment()` helyett egy látható, oldalra rögzített ikont
`Document.RemoveAttachment()` visszaadja `false`	A megadott `name` értékkel nem létezik csatolmány a névfa-ban.	Erősítse meg a pontos nevet a `Document.GetAttachments()` segítségével, mielőtt eltávolítaná.

FAQ

Mi a különbség a Document.AddAttachment és a Page.AddFileAttachment között?

Document.AddAttachment() egy fájlt ágyaz be a dokumentumszinten, látható ikon nélkül bármely oldalon. Page.AddFileAttachment() egy fájlt ágyaz be, és egy kattintható /FileAttachment ikon annotációt helyez el egy adott helyen egy oldalon.

Hogyan listázhatom a dokumentumban már beágyazott összes mellékletet?

Hívja meg a(z) Document.GetAttachments() függvényt, amely minden dokumentumszintű mellékletet Attachment kezelőként tömbben ad vissza, név szerint rendezve.

Hogyan olvashatom ki egy melléklet fájltartalmát?

Hívja meg a(z) GetBytes() függvényt a(z) Attachment (vagy FileAttachmentAnnotation) kezelőn – ez mindkettőn elérhető.

Eltávolíthatok egy mellékletet?

Igen — a(z) Document.RemoveAttachment(name) egy dokumentumszintű mellékletet név alapján eltávolít, és visszaadja, hogy találtak-e ilyet, és eltávolították-e.

API Reference összefoglaló

Osztály/Módszer	Leírás
`Document.AddAttachment()`	Ágyazzon be bájtokat névvel ellátott, dokumentumszintű csatolmányként
`Document.GetAttachments()`	Listázza az összes dokumentumszintű mellékletet
`Document.RemoveAttachment()`	Távolítson el egy dokumentumszintű mellékletet név alapján
`Attachment`	Kezeljen egy beágyazott fájlt; `Name`, `Description`, `MimeType`, `Size`, `GetBytes()`
`Page.AddFileAttachment()`	Ágyazzon be egy fájlt oldalhoz rögzített, kattintható ikon annotációként
`FileAttachmentAnnotation`	Az oldalra rögzített melléklet annotációkezelője; hozzáadja a `Icon`, `FileName`

Lásd még:

Aspose.PDF — Enterprise Documentation