Streams en bestandsbijlagen

Streams en bestandsbijlagen

Voorbij de basis Document.Open/Document.Save overloads, geeft Aspose.PDF FOSS voor .NET je fijnere controle over hoe bytes in en uit een document bewegen — uitbreidbare in-memory buffers voor zeer grote bestanden, en een toegewijde API voor het insluiten, inspecteren en extraheren van bestandsbijlagen via FileSpecification en EmbeddedFileCollection.

In-memory buffers uitbreiden voorbij 2GB

MemoryStream slaat zijn gegevens op in één doorlopend array, wat een limiet heeft rond de 2GB. OptimizedMemoryStream slaat gegevens op in blokken van vaste grootte, zodat het veel grotere documenten kan bevatten wanneer je een PDF volledig in het geheugen opslaat of bouwt.

using Aspose.Pdf;

using var doc = Document.Open("large-input.pdf");
using var buffer = new OptimizedMemoryStream();

doc.Save(buffer);

buffer.Seek(0, SeekOrigin.Begin);
byte[] allBytes = buffer.ToArray();
Console.WriteLine($"Buffer length: {buffer.Length}");

Je kunt er ook direct naar schrijven, op dezelfde manier als met elke Stream:

using var buffer = new OptimizedMemoryStream();
byte[] chunk = System.Text.Encoding.UTF8.GetBytes("raw content chunk");

buffer.Write(chunk, 0, chunk.Length);
buffer.WriteByte(0x0A);
buffer.SetLength(buffer.Length);

Een bestand direct insluiten vanuit een stream

FileSpecification kan een Stream omsluiten in plaats van dat je de bijlage eerst in een byte[] moet bufferen. Dit is handig wanneer de bron van de bijlage zelf een stream is, zoals een geopende bestandshandle.

using Aspose.Pdf;

using var doc = Document.Open("input.pdf");
using var attachmentStream = File.OpenRead("report.csv");
using var spec = new FileSpecification(attachmentStream, "report.csv", "Quarterly report data");

spec.MimeType = "text/csv";
spec.AFRelationship = AFRelationship.Data;
spec.Encoding = FileEncoding.Zip;

doc.EmbeddedFiles.Add(spec);
doc.Save("with-attachment.pdf");

Een bestand insluiten vanuit ruwe bytes

Document.AddEmbeddedFile is een handige methode om een bestand direct vanuit een byte array in te sluiten, zonder rechtstreeks een FileSpecification te construeren.

using Aspose.Pdf;

using var doc = Document.Open("input.pdf");
byte[] fileData = File.ReadAllBytes("appendix.docx");

doc.AddEmbeddedFile(
    "appendix.docx",
    fileData,
    "Supporting appendix",
    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    true,
    DateTime.Now,
    DateTime.Now);

doc.Save("with-appendix.pdf");

Opsommen en extraheren van ingebedde bestanden

Document.EmbeddedFiles is een EmbeddedFileCollection die je kunt opsommen. Elke entry is een FileSpecification, en GetData() retourneert de ruwe bytes van de bijlage.

using Aspose.Pdf;

using var doc = Document.Open("with-attachment.pdf");

if (doc.HasEmbeddedFiles)
{
    foreach (FileSpecification file in doc.EmbeddedFiles)
    {
        Console.WriteLine($"{file.Name} ({file.Size} bytes, {file.MimeType})");
        byte[] contents = file.GetData();
        File.WriteAllBytes(file.Name, contents);
    }
}

Vinden, inspecteren en verwijderen van bijlagen

Gebruik FindByName om een enkele bijlage op te zoeken, Params om de metadata ervan te lezen, en Delete/DeleteByKey om deze te verwijderen.

using Aspose.Pdf;

using var doc = Document.Open("with-attachment.pdf");

FileSpecification? found = doc.EmbeddedFiles.FindByName("report.csv");
if (found?.Params is FileParams info)
{
    Console.WriteLine($"{found.Name}: {info.Size} bytes, checksum {info.CheckSum}, modified {info.ModDate}");
}

doc.EmbeddedFiles.Delete("report.csv");
Console.WriteLine($"Remaining attachments: {doc.EmbeddedFiles.Count}");
doc.Save("cleaned.pdf");

Tips en best practices

• Geef de voorkeur aan OptimizedMemoryStream boven MemoryStream wanneer een in-memory document groter kan worden dan 2GB — MemoryStream gooit een uitzondering zodra de onderliggende array die limiet bereikt.
• Verwijder FileSpecification instanties (en eventuele streams die je handmatig voor hen hebt geopend) – FileSpecification implementeert IDisposable.
• Controleer Document.HasEmbeddedFiles voordat je EmbeddedFiles itereert om onnodige enumeratie op documenten zonder bijlagen over te slaan.
• Stel MimeType en AFRelationship in op elke FileSpecification zodat downstream PDF-consumenten bijlagen correct kunnen classificeren.
• Gebruik EmbeddedFileCollection.FindByName voor een enkele benoemde opzoekactie in plaats van een handmatige lus te schrijven.

Veelvoorkomende problemen

FAQ

Wat is het verschil tussen MemoryStream en OptimizedMemoryStream?

MemoryStream slaat zijn bytes op in één aaneengesloten array die beperkt is tot ongeveer 2GB. OptimizedMemoryStream slaat data op in vaste-grootte blokken in plaats daarvan, zodat het die limiet kan overschrijden – nuttig voor Document.Save operaties die volledig in het geheugen worden uitgevoerd op zeer grote bestanden.

Kan ik een bestand insluiten zonder het eerst in een byte[] te laden?

Ja. FileSpecification(stream, name, description) accepteert een Stream direct, zodat je kunt insluiten vanaf File.OpenRead(...) of elke andere stream zonder het zelf in het geheugen te bufferen.

Hoe haal ik een ingebed bestand weer uit een document?

Itereer doc.EmbeddedFiles en roep GetData() aan op elke FileSpecification om de ruwe bytes op te halen.

Verwijdert EmbeddedFileCollection.Delete(name) elke bijlage met die naam?

Nee — richt je precies op één bijlage met DeleteByKey en de specifieke sleutel uit Keys als meerdere bijlagen dezelfde naam hebben.

Is FileSpecification veilig om opnieuw te gebruiken in meerdere documenten?

Nee. FileSpecification implementeert IDisposable en omsluit een enkele embedded-file-stream; maak een nieuw exemplaar per bijlage per document.

API Reference Samenvatting

Zie ook

• Documentbeheer
• Kern Documentbeheer
• Aspose.PDF for .NET Enterprise Product
• Aspose.PDF for .NET — Enterprise Documentation