إنشاء مستندات PDF باستخدام C#

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

C# .NET PDF API - تنزيل مجاني

Aspose.PDF for .NET هي واجهة برمجة تطبيقات لمعالجة ملفات PDF تتيح لك إنشاء ملفات PDF ومعالجتها من داخل تطبيقات .NET. باستخدام API ، يمكنك إنشاء أنواع مختلفة من التقارير ووثائق العمل ديناميكيًا. واجهة برمجة التطبيقات متاحة كـ DLL القابل للتنزيل بالإضافة إلى أنها مستضافة على NuGet.

Install-Package Aspose.Pdf

إنشاء ملفات PDF في C#

لنبدأ بإنشاء مستند PDF بسيط يحتوي على جزء نصي. فيما يلي خطوات إنشاء ملف PDF باستخدام C#.

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء ملف PDF بسيط باستخدام C#.

// تهيئة كائن المستند
Document document = new Document();

// إضافة صفحة
Page page = document.Pages.Add();

// أضف نصًا إلى صفحة جديدة
page.Paragraphs.Add(new Aspose.Pdf.Text.TextFragment("Hello World!"));

// احفظ ملف PDF 
document.Save("document.pdf");

اقرأ المزيد حول إنشاء مستندات PDF معقدة.

تحرير ملف PDF في C#

يعد تعديل ملف PDF أمرًا بسيطًا مثل إنشاء ملف جديد. ما عليك سوى تحميل الملف باستخدام فئة Document وإجراء العمليات التي تريدها وحفظه. فيما يلي خطوات تعديل ملف PDF.

  • أنشئ كائنًا من فئة Document وقدم مسار ملف PDF لمنشئه.
  • تعامل مع صفحات أو محتوى الوثيقة.
  • احفظ المستند باستخدام طريقة Document.Save().

يوضح نموذج التعليمات البرمجية التالي كيفية تعديل ملف PDF باستخدام C#.

// قم بتحميل ملف PDF
var pdfDocument = new Aspose.Pdf.Document("document.pdf");

// قم ببعض التلاعب ، مثل إضافة صفحة فارغة جديدة
pdfDocument.Pages.Add();

// احفظ ملف PDF المحدث
pdfDocument.Save(modifiedFileName);

إدراج صورة في ملف PDF باستخدام C#

دعنا الآن نتحقق من كيفية إدراج صورة في مستند PDF. فيما يلي خطوات للقيام بذلك.

  • قم بإنشاء كائن من فئة Document لفتح مستند PDF.
  • قم بالوصول إلى الصفحة التي تريد إضافة صورة إليها باستخدام فئة صفحة.
  • أضف الصورة إلى مجموعة الموارد الخاصة بالصفحة.
  • استخدم عوامل التشغيل لوضع الصورة على الصفحة:
    • GSave operator to save the current graphical state.
    • ConcatenateMatrix operator to specify where the image is to be placed.
    • يفعل operator to draw the image on the page.
    • أخيرًا ، استخدم عامل التشغيل GRestore لحفظ الحالة الرسومية المحدثة.
  • احفظ ملف PDF.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة صورة إلى مستند PDF باستخدام C#.

// افتح المستند
Document pdfDocument = new Document("document.pdf");

// ضبط الإحداثيات
int lowerLeftX = 100;
int lowerLeftY = 100;
int upperRightX = 200;
int upperRightY = 200;

// احصل على الصفحة حيث يجب إضافة الصورة
Page page = pdfDocument.Pages[1];

// تحميل الصورة في تيار
FileStream imageStream = new FileStream("aspose-logo.jpg", FileMode.Open);

// أضف صورة إلى مجموعة الصور لمصادر الصفحة
page.Resources.Images.Add(imageStream);

// باستخدام عامل تشغيل GSave: يحفظ هذا المشغل حالة الرسومات الحالية
page.Contents.Add(new Aspose.Pdf.Operators.GSave());

// إنشاء كائنات مستطيل ومصفوفة
Aspose.Pdf.Rectangle rectangle = new Aspose.Pdf.Rectangle(lowerLeftX, lowerLeftY, upperRightX, upperRightY);
Matrix matrix = new Matrix(new double[] { rectangle.URX - rectangle.LLX, 0, 0, rectangle.URY - rectangle.LLY, rectangle.LLX, rectangle.LLY });

// باستخدام عامل ConcatenateMatrix (مصفوفة متسلسلة): يحدد كيفية وضع الصورة
page.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(matrix));
XImage ximage = page.Resources.Images[page.Resources.Images.Count];

// باستخدام عامل التشغيل: يقوم هذا العامل برسم الصورة
page.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));

// باستخدام عامل GRestore: يستعيد هذا المشغل حالة الرسومات
page.Contents.Add(new Aspose.Pdf.Operators.GRestore()); 

// احفظ المستند المحدث
pdfDocument.Save("document.pdf");

اقرأ المزيد حول إدراج الصور في PDF.

إنشاء جدول في PDF باستخدام C#

تعد الجداول مكونًا أساسيًا من المستندات المستخدمة لتنظيم البيانات في شكل صفوف وأعمدة. يوفر لك Aspose.PDF for .NET طريقة بسيطة لإنشاء وإدراج الجداول في مستندات PDF. فيما يلي خطوات إجراء هذه العملية.

  • قم بتحميل ملف PDF باستخدام فئة مستند.
  • قم بتهيئة جدول وضبط أعمدته وصفوفه باستخدام فئة Table.
  • ضبط إعدادات الجدول (أي الحدود).
  • ملء الجدول بإنشاء صفوف باستخدام طريقة Table.Rows.Add().
  • أضف الجدول إلى الصفحة باستخدام طريقة Document.Pages 1 .Paragraphs.Add (Table).
  • احفظ ملف PDF.

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء جدول وإضافته في مستند PDF في C#.

// تحميل مستند PDF المصدر
Aspose.Pdf.Document doc = new Aspose.Pdf.Document("document.pdf");

// يقوم بتهيئة مثيل جديد للجدول
Aspose.Pdf.Table table = new Aspose.Pdf.Table();

// اضبط لون حدود الجدول على LightGray
table.Border = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, .5f, Aspose.Pdf.Color.FromRgb(System.Drawing.Color.LightGray));

// عيّن الحدود لخلايا الجدول
table.DefaultCellBorder = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, .5f, Aspose.Pdf.Color.FromRgb(System.Drawing.Color.LightGray));

// قم بإنشاء حلقة لإضافة 10 صفوف
for (int row_count = 1; row_count < 10; row_count++)
{
    // أضف صفًا إلى الجدول
    Aspose.Pdf.Row row = table.Rows.Add();
    // أضف خلايا الجدول
    row.Cells.Add("Column (" + row_count + ", 1)");
    row.Cells.Add("Column (" + row_count + ", 2)");
    row.Cells.Add("Column (" + row_count + ", 3)");
}

// أضف كائن جدول إلى الصفحة الأولى من مستند الإدخال
doc.Pages[1].Paragraphs.Add(table);

// احفظ المستند المحدث الذي يحتوي على كائن جدول
doc.Save("document_with_table_out.pdf");

اقرأ المزيد حول إنشاء الجداول في PDF.

إنشاء نموذج في PDF في C#

تُستخدم النماذج الموجودة في ملفات PDF لجمع البيانات من القراء. يمكنك إدراج مربعات النص ومربعات الاختيار وأزرار الاختيار وعناصر التحكم الأخرى المدعومة في نماذج PDF. يدعم تنسيق PDF نوعين من النماذج ؛ نماذج Acro ونماذج XFA (انظر التفاصيل).فيما يلي خطوات إنشاء وإضافة نماذج في PDF.

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نماذج إلى مستند PDF باستخدام C#.

// افتح المستند
Document pdfDocument = new Document("document.pdf");

// قم بإنشاء حقل
TextBoxField textBoxField = new TextBoxField(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(100, 200, 300, 300));
textBoxField.PartialName = "textbox1";
textBoxField.Value = "Text Box";

// TextBoxField.Border = حد جديد (
Border border = new Border(textBoxField);
border.Width = 5;
border.Dash = new Dash(1, 1);
textBoxField.Border = border;

textBoxField.Color = Aspose.Pdf.Color.FromRgb(System.Drawing.Color.Green);

// أضف حقلاً إلى المستند
pdfDocument.Form.Add(textBoxField, 1);

// احفظ ملف PDF المعدل
pdfDocument.Save("output.pdf");

اقرأ المزيد حول إنشاء النماذج في PDF.

استنتاج

في هذا المنشور ، تعلمت كيفية إنشاء ملفات PDF من البداية باستخدام C#. علاوة على ذلك ، تعرفت على كيفية إدراج أنواع مختلفة من المكونات مثل النص والصور والجداول والنماذج في مستند PDF برمجيًا. يمكنك معرفة المزيد عن واجهة برمجة تطبيقات PDF باستخدام التوثيق.

أنظر أيضا

معلومات: يوفر Aspose تطبيق ويب مجانيًا عبر الإنترنت يتيح لك عرض ملفات PDF عبر الإنترنت ، وآخر يتيح لك تحويل ملفات PDF إلى فيديو ، ويتيح لك [تحرير ملفات PDF عبر الإنترنت] 4 .