فرمت PDF از افزودن پیوستها به فایل PDF مشابه پیوستهای ایمیل پشتیبانی میکند. یک پیوست PDF می تواند از TXT، DOCX، XLSX یا هر فرمت سند دیگری باشد. در این مقاله، نحوه پیاده سازی برخی از ویژگی های اساسی دستکاری پیوست PDF را در برنامه های دات نت خود خواهید آموخت. تا پایان این مقاله، میتوانید پیوستها را در یک پیدیاف بهصورت برنامهنویسی با استفاده از سی شارپ استخراج، اضافه یا حذف کنید.
- PDF Attachment Manipulation API - دانلود رایگان
- افزودن ضمیمه به PDF با استفاده از سی شارپ
- استخراج پیوست PDF با استفاده از سی شارپ
- حذف پیوست ها از PDF با استفاده از C#
PDF Attachment Manipulation API - دانلود رایگان
Aspose.PDF for .NET یک API دستکاری PDF شناخته شده است که به شما امکان می دهد فایل های PDF را یکپارچه پردازش کنید. میتوانید فایلهای PDF را بخوانید، ایجاد، ویرایش و تبدیل کنید و پیوستهای PDF را در چند مرحله دستکاری کنید. API را می توان به عنوان DLL یا MSI دانلود و همچنین با استفاده از NuGet نصب کرد.
Install-Package Aspose.Pdf
افزودن پیوست به PDF با استفاده از سی شارپ
Aspose.PDF for .NET همچنین به شما امکان می دهد پیوست ها را به یک فایل PDF اضافه کنید. برای این کار، فقط باید فایل را با استفاده از کلاس FileSpecification به مجموعه Document.EmbeddedFiles اضافه کنید. مراحل زیر برای افزودن پیوست به سند PDF آمده است.
- با استفاده از کلاس Document یک سند PDF جدید ایجاد کنید.
- یک نمونه از کلاس FileSpecification برای بارگیری فایل پیوست ایجاد کنید.
- از روش Document.EmbeddedFiles.Add(FileSpecification) برای افزودن پیوست استفاده کنید.
- سند را با استفاده از روش Document.Save(String) ذخیره کنید.
نمونه کد زیر نحوه افزودن پیوست به یک سند PDF را با استفاده از C# نشان می دهد.
// برای نمونههای کامل و فایلهای داده، لطفاً به https://github.com/aspose-pdf/Aspose.PDF-for-.NET بروید
// سند را باز کنید
Document pdfDocument = new Document("document.pdf");
// فایل جدیدی را تنظیم کنید تا به عنوان پیوست اضافه شود
FileSpecification fileSpecification = new FileSpecification("test.txt", "Sample text file");
// پیوست را به مجموعه پیوست سند اضافه کنید
pdfDocument.EmbeddedFiles.Add(fileSpecification);
// ذخیره خروجی جدید
pdfDocument.Save("output.pdf");
استخراج پیوست PDF با استفاده از سی شارپ
اول از همه، بیایید نحوه بازیابی پیوست ها از یک سند PDF را بررسی کنیم. برای این کار مراحل زیر را دنبال کنید:
- یک نمونه از کلاس Document ایجاد کنید.
- با استفاده از ویژگی Document.EmbeddedFiles پیوست ها را در یک شی EmbeddedFileCollection دریافت کنید.
- با استفاده از شیء FileSpecification از میان پیوستها در EmbeddedFileCollection حلقه بزنید.
- با استفاده از شیء FileSpecification به خصوصیات هر پیوست دسترسی پیدا کنید.
- پیوست را به صورت فایل (در صورت نیاز) ذخیره کنید.
نمونه کد زیر نحوه استخراج پیوست های PDF با استفاده از C# را نشان می دهد.
// برای نمونههای کامل و فایلهای داده، لطفاً به https://github.com/aspose-pdf/Aspose.PDF-for-.NET بروید
// سند را باز کنید
Document pdfDocument = new Document("document.pdf");
// فایل تعبیه شده خاص را دریافت کنید
foreach(FileSpecification fileSpecification in pdfDocument.EmbeddedFiles)
{
// ویژگی های فایل را دریافت کنید
Console.WriteLine("Name: {0}", fileSpecification.Name);
Console.WriteLine("Description: {0}", fileSpecification.Description);
Console.WriteLine("Mime Type: {0}", fileSpecification.MIMEType);
// بررسی کنید که آیا شی پارامتر حاوی پارامترها است یا خیر
if (fileSpecification.Params != null)
{
Console.WriteLine("CheckSum: {0}",
fileSpecification.Params.CheckSum);
Console.WriteLine("Creation Date: {0}",
fileSpecification.Params.CreationDate);
Console.WriteLine("Modification Date: {0}",
fileSpecification.Params.ModDate);
Console.WriteLine("Size: {0}", fileSpecification.Params.Size);
}
// پیوست را دریافت کنید و در فایل یا پخش جریانی بنویسید
byte[] fileContent = new byte[fileSpecification.Contents.Length];
fileSpecification.Contents.Read(fileContent, 0, fileContent.Length);
FileStream fileStream = new FileStream(fileSpecification.Name, FileMode.Create);
fileStream.Write(fileContent, 0, fileContent.Length);
fileStream.Close();
}
حذف پیوست ها از PDF با استفاده از C#
شما می توانید همه یا یک پیوست خاص را از یک فایل PDF حذف کنید. برای این کار، Aspose.PDF برای دات نت روش های زیر را ارائه می دهد:
- حذف() - Deletes all the attachments.
- حذف (نام فایل رشته) - Deletes attachment by name.
- DeleteByKey (کلید رشته) - Deletes attachment by key in the collection.
در زیر مراحل حذف پیوستها از یک PDF آمده است.
- یک نمونه از کلاس Document برای بارگیری فایل PDF ایجاد کنید.
- از Document.EmbeddedFiles.Delete() (یا روش حذف دیگر) برای حذف پیوست ها استفاده کنید.
- فایل را با استفاده از روش Document.Save(String) ذخیره کنید.
نمونه کد زیر نحوه حذف پیوست ها از یک فایل PDF در سی شارپ را نشان می دهد.
// برای نمونههای کامل و فایلهای داده، لطفاً به https://github.com/aspose-pdf/Aspose.PDF-for-.NET بروید
// سند را باز کنید
Document pdfDocument = new Document("document.pdf");
// تمام پیوست ها را حذف کنید
pdfDocument.EmbeddedFiles.Delete();
// فایل به روز شده را ذخیره کنید
pdfDocument.Save("output.pdf");
نتیجه
در این مقاله نحوه دستکاری فایل های پیوست در اسناد PDF را به صورت برنامه ای مشاهده کرده اید. راهنمای گام به گام، مراجع API و نمونه کد نحوه بازیابی، افزودن و حذف پیوستها در فایلهای PDF با استفاده از C# را نشان دادهاند. می توانید با استفاده از مستندات درباره Aspose.PDF برای دات نت اطلاعات بیشتری کسب کنید.