Работа с вложениями — фасады

В этом разделе мы объясним, как работать с вложениями в формате 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");
}