添付ファイルの操作 - ファサード

このセクションでは、Aspose.PDF for .NETファサードを使用してPDF内の添付ファイルを操作する方法を説明します。添付ファイルとは、親ドキュメントに添付された追加のファイルであり、pdf、word、画像、またはその他のファイルタイプのさまざまな形式があります。PDFに添付ファイルを追加する方法、添付ファイルの情報を取得してファイルに保存する方法、C#を使用してPDFから添付ファイルをプログラムで削除する方法を学びます。

既存のPDFからファイルを添付する

PdfContentEditorクラスを使用して、既存のPDFファイルに添付ファイルを追加できます。添付ファイルは、ディスク上のファイルからファイルパスを使用して追加できます。AddDocumentAttachmentメソッドを使用して添付ファイルを追加できます。このメソッドは、ファイルパスと添付ファイルの説明の2つの引数を取ります。まず、既存のPDFファイルを開き、その中に添付ファイルを追加する必要があります。その後、PdfContentEditorのSaveメソッドを使用して出力PDFファイルを保存できます。

以下のコードスニペットは、ファイルから添付ファイルを追加する方法を示しています。たとえば、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からストリームを添付する

添付ファイルは、AddDocumentAttachmentメソッドを使用して、ストリーム - FileStreamからPDFファイルに追加できます。このメソッドは、ストリーム、添付ファイル名、および添付ファイルの説明の3つの引数を取ります。添付ファイルを追加するには、PdfContentEditorクラスのオブジェクトを作成し、BindPdfメソッドを使用して入力PDFファイルをバインドする必要があります。その後、AddDocumentAttachmentメソッドを呼び出して添付ファイルを追加できます。最後に、更新されたPDFファイルを保存するためにSaveメソッドを呼び出すことができます。以下のコードスニペットは、ストリームから添付ファイルを追加する方法を示しています。

.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ファイルからすべての添付ファイルを削除する

PdfContentEditorクラスのDeleteAttachmentsメソッドを使用すると、既存のPDFファイルからすべての添付ファイルを削除できます。DeleteAttachmentsメソッドを呼び出します。最後に、更新されたPDFファイルを保存するために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 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");
}