Attachments

Deze pagina behandelt het insluiten van bestanden in een PDF. Er zijn twee verschillende mechanismen: documentniveau-bijlagen, die ingesloten bestanden zijn zonder zichtbare aanwezigheid op een pagina, en paginageankerde bestandbijlage-annotaties, die een klikbaar pictogram op een specifieke pagina plaatsen.

Documentniveau-bijlagen

Document.AddAttachment() embedt bytes onder een name, en voegt het toe of werkt het bij in de naamboom van ingesloten bestanden van het document — het opnieuw toevoegen met dezelfde naam overschrijft de bestaande invoer. Het retourneert een Attachment handle. Document.GetAttachments() retourneert elke documentniveau-bijlage als een array van Attachment handles, gesorteerd op naam, en Document.RemoveAttachment() verwijdert er een op naam.

De Attachment handle maakt Name, Description, MimeType, Size, CreationDate en ModDate beschikbaar als eigenschappen, GetBytes() om de ruwe inhoud van het ingesloten bestand weer uit te lezen, en GetField() / SetField() / RemoveField() voor toegang op lager niveau tot individuele /Filespec velden. De optionele AttachmentOptions die aan AddAttachment() wordt doorgegeven, accepteert mimeType, description, compress, creationDate en modDate.

Er is geen geverifieerd code-voorbeeld beschikbaar voor deze API in de huidige kennis-snapshot voor dit platform — zie de API Reference Samenvatting hieronder voor de exacte methode- en eigenschapsnamen.

Paginageankerde bestandbijlagen

Page.AddFileAttachment() voegt een bestand in en plaatst een /FileAttachment pictogramannotatie op een gegeven rect op een specifieke pagina, en retourneert een FileAttachmentAnnotation. In tegenstelling tot een document-niveau bijlage, is deze zichtbaar en klikbaar in een PDF-viewer. FileAttachmentAnnotation deelt de gemeenschappelijke annotatie-eigenschappen (Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity) plus zijn eigen Icon en FileName, en ondersteunt GetBytes() om de ingebedde inhoud te lezen en Flatten() om zijn pictogram in statische paginacontent te verwerken.

Tips en best practices

Gebruik een document-niveau bijlage (Document.AddAttachment()) voor een bestand dat mee moet reizen met de PDF zonder op een pagina te verschijnen; gebruik Page.AddFileAttachment() wanneer het bestand moet worden weergegeven door een klikbaar pictogram op een specifieke locatie.
Document.AddAttachment() overschrijft een bestaande bijlage met dezelfde name — controleer eerst Document.GetAttachments() als je onbedoeld vervangen wilt voorkomen.
Lees de inhoud van een bijlage opnieuw met GetBytes() op elk type handle — de methode bestaat zowel op Attachment als FileAttachmentAnnotation.

Veelvoorkomende problemen

Probleem	Oorzaak	Oplossing
Een nieuw toegevoegde bijlage heeft een bestaande vervangen	`Document.AddAttachment()` werd aangeroepen met een `name` die al in gebruik is	Roep `Document.GetAttachments()` eerst aan om te controleren op een naamconflict
Bijlage heeft geen zichtbaar pictogram op de pagina	`Document.AddAttachment()` werd gebruikt, wat op documentniveau is en volgens ontwerp geen paginapresentie heeft	Gebruik `Page.AddFileAttachment()` in plaats daarvan voor een zichtbaar, pagina-gebonden pictogram
`Document.RemoveAttachment()` retourneert `false`	Er bestaat geen bijlage met de opgegeven `name` in de naamboom	Bevestig de exacte naam via `Document.GetAttachments()` voordat u verwijdert

FAQ

Wat is het verschil tussen Document.AddAttachment en Page.AddFileAttachment?

Document.AddAttachment() voegt een bestand in op documentniveau zonder zichtbaar pictogram op enige pagina. Page.AddFileAttachment() voegt een bestand in en plaatst een klikbare /FileAttachment pictogramannotatie op een specifieke locatie op één pagina.

Hoe kan ik elke bijlage die al in een document is ingebed, opsommen?

Roep Document.GetAttachments() aan, die elke document-niveau bijlage retourneert als een array van Attachment handles, gesorteerd op naam.

Hoe kan ik de bestandsinhoud van een bijlage teruglezen?

Roep GetBytes() aan op de Attachment (of FileAttachmentAnnotation) handle — deze is op beide beschikbaar.

Kan ik een bijlage verwijderen?

Ja — Document.RemoveAttachment(name) verwijdert een document-niveau bijlage op naam en retourneert of er een is gevonden en verwijderd.

API Reference Samenvatting

Klasse/Methode	Beschrijving
`Document.AddAttachment()`	Integreer bytes als een benoemde, document-niveau bijlage
`Document.GetAttachments()`	Lijst alle bijlagen op documentniveau
`Document.RemoveAttachment()`	Verwijder een document-niveaubijlage op naam
`Attachment`	Verwerk één ingesloten bestand; `Name`, `Description`, `MimeType`, `Size`, `GetBytes()`
`Page.AddFileAttachment()`	Sluit een bestand in als een paginagelijkende, klikbare pictogramannotatie
`FileAttachmentAnnotation`	Het paginageankerde bijlage-annotatie-handvat; voegt `Icon`, `FileName` toe

Zie ook

Aspose.PDF — Enterprise Documentation