العمل مع المرفقات - الواجهات

في هذا القسم، سنشرح كيفية العمل مع المرفقات في PDF باستخدام Aspose.PDF for .NET الواجهات. المرفق هو ملف إضافي مرتبط بمستند رئيسي، ويمكن أن يكون مجموعة متنوعة من أنواع الملفات، مثل pdf، word، صورة، أو ملفات أخرى. ستتعلم كيفية إضافة مرفقات إلى pdf، والحصول على معلومات المرفق، وحفظه في ملف، وحذف المرفق من PDF برمجيًا باستخدام C#.

إضافة مرفق من ملف في PDF موجود

يمكنك إضافة مرفق في ملف PDF موجود باستخدام فئة PdfContentEditor. يمكن إضافة المرفق من ملف على القرص باستخدام مسار الملف. يمكنك إضافة المرفق باستخدام طريقة AddDocumentAttachment. تأخذ هذه الطريقة وسيطين: مسار الملف ووصف المرفق. أولاً، تحتاج إلى فتح ملف PDF الموجود وإضافة المرفق إليه. ثم يمكنك حفظ ملف PDF الناتج باستخدام طريقة Save من فئة PdfContentEditor.

تظهر الشيفرة التالية كيفية إضافة مرفق من ملف. على سبيل المثال، دعنا نضيف ملف MP3.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddAttachment()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using (var editor =  new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "AddAttachment.pdf")))
    {
        editor.AddDocumentAttachment(dataDir + "Demo_MP3.mp3", "Demo MP3 file");

        // Save PDF document
        editor.Save(dataDir + "AddAttachment_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddAttachment()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using var editor = new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "AddAttachment.pdf"));
    editor.AddDocumentAttachment(dataDir + "Demo_MP3.mp3", "Demo MP3 file");

    // Save PDF document
    editor.Save(dataDir + "AddAttachment_out.pdf");
}

إضافة مرفق من دفق في PDF موجود

يمكن إضافة مرفق في ملف PDF من دفق - FileStream - باستخدام طريقة AddDocumentAttachment. تأخذ هذه الطريقة ثلاثة وسائط: الدفق، اسم المرفق، ووصف المرفق. لإضافة المرفق، تحتاج إلى إنشاء كائن من فئة PdfContentEditor وربط ملف PDF المدخل باستخدام طريقة BindPdf. بعد ذلك، يمكنك استدعاء طريقة AddDocumentAttachment لإضافة المرفق. أخيرًا، يمكنك استدعاء طريقة Save لحفظ ملف PDF المحدث. تظهر الشيفرة التالية كيفية إضافة مرفق من دفق.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddAttachment()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using (var editor = new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "AddAttachment.pdf")))
    {
        var fileStream = File.OpenRead(dataDir + "Demo_MP3.mp3");
        editor.AddDocumentAttachment(fileStream, "Demo_MP3.mp3", "Demo MP3 file");

        // Save PDF document
        editor.Save(dataDir + "AddAttachment_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddAttachment()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using var editor = new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "AddAttachment.pdf"));

    var fileStream = File.OpenRead(dataDir + "Demo_MP3.mp3");
    editor.AddDocumentAttachment(fileStream, "Demo_MP3.mp3", "Demo MP3 file");

    // Save PDF document
    editor.Save(dataDir + "AddAttachment_out.pdf");
}

حذف جميع المرفقات من ملف PDF موجود

تتيح لك طريقة DeleteAttachments من فئة PdfContentEditor حذف جميع المرفقات من ملف PDF موجود. استدعِ طريقة DeleteAttachments. أخيرًا، يجب عليك استدعاء طريقة Save لحفظ ملف PDF المحدث. تظهر الشيفرة التالية كيفية حذف جميع المرفقات من ملف PDF موجود.

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void DeleteAllAttachments()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using (var editor = new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "DeleteAllAttachments.pdf")))
    {
        editor.DeleteAttachments();

        // Save PDF document
        editor.Save(dataDir + "DeleteAllAttachments_out.pdf");
    }
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void DeleteAllAttachments()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_WorkingDocuments();

    // Instantiate PdfContentEditor object
    using var editor = new Aspose.Pdf.Facades.PdfContentEditor(new Aspose.Pdf.Document(dataDir + "DeleteAllAttachments.pdf"));
    editor.DeleteAttachments();

    // Save PDF document
    editor.Save(dataDir + "DeleteAllAttachments_out.pdf");
}