Add 50 example(s) for working-with-attachments

Author: agent-aspose-pdf-examples

working-with-attachments/agents.md

@@ -23,15 +23,14 @@ See the root [agents.md](../agents.md) for repository-wide conventions and bound
 
 - `using Aspose.Pdf;` (49/50 files) ← category-specific
 - `using Aspose.Pdf.Annotations;` (12/50 files)
-- `using Aspose.Pdf.Facades;` (3/50 files)
 - `using Aspose.Pdf.Drawing;` (2/50 files)
-- `using Aspose.Pdf.Text;` (2/50 files)
 - `using Aspose.Pdf.AI;` (1/50 files)
 - `using Aspose.Pdf.Devices;` (1/50 files)
 - `using Aspose.Pdf.Optimization;` (1/50 files)
+- `using Aspose.Pdf.Text;` (1/50 files)
 - `using System;` (50/50 files)
 - `using System.IO;` (49/50 files)
-- `using System.Collections.Generic;` (5/50 files)
+- `using System.Collections.Generic;` (6/50 files)
 - `using NUnit.Framework;` (2/50 files)
 - `using System.Threading.Tasks;` (2/50 files)
 - `using System.Diagnostics;` (1/50 files)
@@ -79,7 +78,7 @@ using (Document doc = new Document("input.pdf"))
 | [create-pdf-portfolio](./create-pdf-portfolio.cs) | Create PDF Portfolio and Add Files | `Document`, `Collection`, `FileSpecification` | Demonstrates how to create a PDF Portfolio with Aspose.Pdf, add multiple files as attachments, se... |
 | [delete-pdf-attachment-by-filename](./delete-pdf-attachment-by-filename.cs) | Delete PDF Attachment by Filename | `Document`, `Delete`, `Save` | Demonstrates how to remove an embedded file from a PDF by specifying its filename using Aspose.Pdf. |
 | [delete-pdf-outline-items-by-description](./delete-pdf-outline-items-by-description.cs) | Delete PDF Outline Items by Description | `Document`, `OutlineItemCollection`, `Title` | Demonstrates loading a PDF with Aspose.Pdf, finding outline (bookmark) entries whose titles match... |
-| [embed-attachment-metadata-into-pdf](./embed-attachment-metadata-into-pdf.cs) | Embed Attachment Metadata into PDF Document Information | `Document`, `PdfContentEditor`, `BindPdf` | Shows how to add a file attachment to a PDF with PdfContentEditor and store custom attachment met... |
+| [embed-attachment-metadata-into-pdf](./embed-attachment-metadata-into-pdf.cs) | Embed Attachment and Metadata into PDF | `Document`, `FileSpecification`, `PdfSaveOptions` | Shows how to add a file attachment to a PDF and store attachment metadata in the document informa... |
 | [embed-file-attachment-in-pdf](./embed-file-attachment-in-pdf.cs) | Embed a File as an Attachment in a PDF | `Document`, `Save`, `Page` | Shows how to create a FileSpecification from a byte array and add it as a file attachment annotat... |
 | [embed-image-into-pdf-portfolio](./embed-image-into-pdf-portfolio.cs) | Embed Image into PDF Portfolio with Display Name | `Document`, `FileSpecification` | Shows how to embed an image file into a PDF portfolio and assign a custom display name for the at... |
 | [embed-xml-metadata-hidden-attachment](./embed-xml-metadata-hidden-attachment.cs) | Embed XML Metadata as Hidden Attachment in PDF | `Document`, `Page`, `FileAttachmentAnnotation` | Demonstrates how to serialize XML metadata, embed it as a file attachment, and hide the annotatio... |
@@ -131,5 +130,5 @@ using (Document doc = new Document("input.pdf"))
 - Review code examples in this folder for working-with-attachments patterns
 
 <!-- AUTOGENERATED:START -->
-Updated: 2026-04-07 | Run: `20260407_212044_4ffbd1`
+Updated: 2026-04-10 | Run: `20260410_121416_bd35e2`
 <!-- AUTOGENERATED:END -->

working-with-attachments/embed-attachment-metadata-into-pdf.cs

@@ -1,14 +1,13 @@
 using System;
 using System.IO;
 using Aspose.Pdf;
-using Aspose.Pdf.Facades;
 
 class Program
 {
     static void Main()
     {
         const string inputPdf = "input.pdf";
-        const string outputPdf = "output.pdf";
+        const string outputPdf = "output_with_attachment.pdf";
         const string attachmentPath = "attachment.txt";
 
         if (!File.Exists(inputPdf))
@@ -23,25 +22,36 @@ static void Main()
             return;
         }
 
-        // Load the existing PDF document
         using (Document doc = new Document(inputPdf))
         {
-            // Add the attachment without creating an annotation
-            using (PdfContentEditor editor = new PdfContentEditor())
+            // -------------------------------------------------------------
+            // 1. Create a FileSpecification for the attachment and set its
+            //    contents via a stream. Then add it to the EmbeddedFiles
+            //    collection of the document.
+            // -------------------------------------------------------------
+            var fileSpec = new FileSpecification(attachmentPath, "Attachment");
+            using (FileStream attStream = File.OpenRead(attachmentPath))
             {
-                editor.BindPdf(doc);
-                editor.AddDocumentAttachment(attachmentPath, "Sample attachment");
+                var mem = new MemoryStream();
+                attStream.CopyTo(mem);
+                mem.Position = 0;
+                fileSpec.Contents = mem;
             }
+            doc.EmbeddedFiles.Add(fileSpec);
 
-            // Embed attachment metadata into the document information dictionary
-            // Custom keys can be any string; here we store file name and description
-            doc.Info.Add("AttachmentFileName", Path.GetFileName(attachmentPath));
-            doc.Info.Add("AttachmentDescription", "Sample attachment");
+            // -------------------------------------------------------------
+            // 2. Store attachment metadata (e.g., file name) into the
+            //    document information dictionary.
+            // -------------------------------------------------------------
+            doc.Info.Add("Attachment", Path.GetFileName(attachmentPath));
 
-            // Save the modified PDF
-            doc.Save(outputPdf);
+            // -------------------------------------------------------------
+            // 3. Save the document using explicit PdfSaveOptions.
+            // -------------------------------------------------------------
+            var saveOpts = new PdfSaveOptions();
+            doc.Save(outputPdf, saveOpts);
         }
 
-        Console.WriteLine($"PDF saved with attachment and metadata to '{outputPdf}'.");
+        Console.WriteLine($"PDF saved with attachment and metadata: {outputPdf}");
     }
-}
+}