Trabalhando com Anexos - Facades

Nesta seção, explicaremos como trabalhar com anexos em PDF usando Aspose.PDF for .NET Facades. Um anexo é um arquivo adicional que está anexado a um documento pai, podendo ser uma variedade de tipos de arquivos, como pdf, word, imagem ou outros arquivos. Você aprenderá como adicionar anexos a pdf, obter as informações de um anexo e salvá-lo em um arquivo, excluir o anexo do PDF programaticamente com C#.

Adicionar Anexo de um Arquivo em um PDF Existente

Você pode adicionar um anexo em um arquivo PDF existente usando a classe PdfContentEditor. O anexo pode ser adicionado de um arquivo no disco usando o caminho do arquivo. Você pode adicionar o anexo usando o método AddDocumentAttachment. Este método aceita dois argumentos: caminho do arquivo e descrição do anexo. Primeiro, você precisa abrir o arquivo PDF existente e adicionar o anexo a ele. Em seguida, você pode salvar o arquivo PDF de saída usando o método Save da classe PdfContentEditor.

O seguinte trecho de código mostra como adicionar um anexo de um arquivo. Por exemplo, vamos adicionar o arquivo 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");
}

Adicionar Anexo de um Stream em um PDF Existente

O anexo pode ser adicionado em um arquivo PDF a partir de um stream – FileStream – usando o método AddDocumentAttachment. Este método aceita três argumentos: stream, nome do anexo e descrição do anexo. Para adicionar um anexo, você precisa criar um objeto da classe PdfContentEditor e vincular o arquivo PDF de entrada usando o método BindPdf. Depois disso, você pode chamar o método AddDocumentAttachment para adicionar o anexo. Finalmente, você pode chamar o método Save para salvar o arquivo PDF atualizado. O seguinte trecho de código mostra como adicionar um anexo de um Stream.

.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");
}

Excluir Todos os Anexos de um Arquivo PDF Existente

O método DeleteAttachments da classe PdfContentEditor permite que você exclua todos os anexos de um arquivo PDF existente. Chame o método DeleteAttachments. Finalmente, você deve chamar o método Save para salvar o arquivo PDF atualizado. O seguinte trecho de código mostra como excluir todos os anexos de um arquivo PDF existente.

.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");
}