عرض الجدول في مستند PDF

مقدمة

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

المتطلبات الأساسية

قبل أن نتعمق في الكود، إليك ما تحتاجه:

• Visual Studio: تأكد من تثبيت Visual Studio على جهازك. يمكنك تنزيلههنا.
• Aspose.PDF لـ .NET: يمكنك بسهولة تنزيل مكتبة Aspose.PDF منصفحة إصدار Aspose.
• المعرفة الأساسية بلغة C#: إن فهم أساسيات لغة C# سوف يساعدك على المتابعة بشكل أفضل.
• .NET Framework: من الناحية المثالية، تأكد من أنك تعمل في بيئة .NET متوافقة.

بمجرد تعيين هذه المتطلبات الأساسية، ستكون جاهزًا لبدء إنشاء مستندات PDF الخاصة بك!

استيراد الحزم

في بداية ملف C# الخاص بك، ستحتاج إلى استيراد مساحات الأسماء Aspose.PDF اللازمة. يتيح لك هذا الاستفادة من وظائف المكتبة في مشروعنا.

using System;
using System.IO;
using Aspose.Pdf;
using Aspose.Pdf.Text;

تأكد من أنك قمت بإضافة المراجع اللازمة إلى مكتبة Aspose.PDF في مشروعك. إذا كنت تستخدم NuGet، فيمكنك إضافتها بسهولة عن طريق البحث عنAspose.PDF.

الآن بعد أن قمنا بإعداد كل شيء، فلنبدأ في تقسيم العملية إلى خطوات يمكن إدارتها لعرض جدول في مستند PDF. لا تقلق؛ سأقوم بإرشادك خلال كل خطوة بإرشادات واضحة!

الخطوة 1: إعداد معلومات المستند والصفحة

أولاً وقبل كل شيء، نحتاج إلى إنشاء مستند جديد وتكوين إعدادات الصفحة الخاصة به. وإليك كيفية القيام بذلك:

string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
PageInfo pageInfo = doc.PageInfo;
Aspose.Pdf.MarginInfo marginInfo = pageInfo.Margin;

marginInfo.Left = 37;
marginInfo.Right = 37;
marginInfo.Top = 37;
marginInfo.Bottom = 37;

pageInfo.IsLandscape = true;

توضيح:

• نبدأ بتحديد المكان الذي سيتم حفظ مستندنا فيه (dataDir).
• ثم نقوم بإنشاء مثيل جديد لـDocument فصل.
• نقوم بتهيئة هوامش الصفحة لإنشاء مساحة للتنفس حول طاولتنا.
• وأخيرًا، قمنا بتعيين اتجاه المستند إلى الاتجاه الأفقي، مما يساعد عند عرض الجداول الأوسع.

الخطوة 2: إنشاء الجدول الأول

بعد ذلك، دعنا نقوم بإنشاء جدولنا الأول ونملأه ببعض البيانات النموذجية:

Aspose.Pdf.Table table = new Aspose.Pdf.Table();
table.ColumnWidths = "50 100"; // تحديد عرض الأعمدة

الشرح: هنا، نقوم بإنشاء مثيل لـTable قم بتعيين عرض العمود. سيكون عرض العمود الأول 50 وحدة، وسيكون عرض العمود الثاني 100 وحدة.

الخطوة 3: ملء الجدول بالصفوف

الآن، دعونا نضيف صفوفًا إلى جدولنا في حلقة:

Page curPage = doc.Pages.Add(); // إضافة صفحة جديدة
for (int i = 1; i <= 120; i++)
{
    Aspose.Pdf.Row row = table.Rows.Add();
    row.FixedRowHeight = 15; // تعيين ارتفاع ثابت للصفوف
    
    Aspose.Pdf.Cell cell1 = row.Cells.Add();
    cell1.Paragraphs.Add(new TextFragment("Content 1"));
    
    Aspose.Pdf.Cell cell2 = row.Cells.Add();
    cell2.Paragraphs.Add(new TextFragment("HHHHH"));
}

توضيح:

• هنا نقوم بإنشاء صفحة جديدة لإضافة جدولنا.
• نحن نستخدمfor حلقة لإضافة 120 صفًا إلى جدولنا. كل صف له ارتفاع ثابت يبلغ 15 وحدة.
• داخل كل صف، نضيف خليتين ونملأهما بالنص.

الخطوة 4: إضافة الجدول الأول إلى الصفحة

بمجرد ملء الجدول، سنضيفه إلى الصفحة الحالية:

Aspose.Pdf.Paragraphs paragraphs = curPage.Paragraphs;
paragraphs.Add(table);

التوضيح: هذه الخطوة تقوم ببساطة بإضافة الجدول الذي أنشأناه إلى فقرات الصفحة الحالية، مما يجعل الجدول مرئيًا في مستند PDF.

الخطوة 5: إنشاء جدول ثانٍ

الآن، دعونا ننشئ جدولًا ثانيًا بمحتوى مختلف ونضيفه إلى صفحة جديدة:

Aspose.Pdf.Table table1 = new Aspose.Pdf.Table();
table1.ColumnWidths = "100 100";
for (int i = 1; i <= 10; i++)
{
    Aspose.Pdf.Row row = table1.Rows.Add();
    Aspose.Pdf.Cell cell1 = row.Cells.Add();
    cell1.Paragraphs.Add(new TextFragment("LAAAAAAA"));
    
    Aspose.Pdf.Cell cell2 = row.Cells.Add();
    cell2.Paragraphs.Add(new TextFragment("LAAGGGGGG"));
}
table1.IsInNewPage = true; // إعداد الجدول الثاني ليظهر في صفحة جديدة
paragraphs.Add(table1);

توضيح:

• يؤدي مقتطف التعليمات البرمجية هذا إلى إنشاء جدول جديد يحتوي على عمودين، يبلغ عرض كل منهما 100 وحدة.
• أfor تضيف الحلقة 10 صفوفًا بمحتوى العينة.
• عن طريق الإعدادtable1.IsInNewPage إذا كان الأمر كذلك، فإننا نضمن ظهور هذا الجدول على صفحة جديدة، مما يبقي الأشياء منظمة وغير مزدحمة.

الخطوة 6: احفظ المستند

الآن بعد أن أصبحت جداولنا جاهزة، فلنحفظ مستندنا:

dataDir = dataDir + "IsNewPageProperty_Test_out.pdf";
doc.Save(dataDir);

الشرح: نحدد اسم الملف ونحفظ المستند في الدليل المحدد. عند تشغيل هذا الكود، يتم إنشاء ملف PDF بعنوانIsNewPageProperty_Test_out.pdf سيتم إنشاؤه في الموقع المحدد الخاص بك.

الخطوة 7: رسالة التأكيد

أخيرًا، لإعلام المستخدم بأن كل شيء سار بسلاسة، يمكننا إضافة رسالة وحدة تحكم ودية:

Console.WriteLine("\nTable rendered successfully on a page.\nFile saved at " + dataDir);

التوضيح: هذه طريقة بسيطة لتأكيد نجاح العملية ومكان العثور على ملف PDF الجديد للمستخدم.

خاتمة

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

الأسئلة الشائعة

هل يمكنني تخصيص مظهر الجداول في Aspose.PDF؟

بالتأكيد! يمكنك ضبط الألوان والحدود وأنماط الخطوط والخصائص الأخرى لتحسين مظهر الجداول الخاصة بك.

هل استخدام Aspose.PDF مجاني؟

يقدم Aspose.PDF إصدارًا تجريبيًا مجانيًا، ولكن للاستخدام التجاري، يلزم الشراء. يمكنك التحقق من الأسعارهنا.

كيف يمكنني الحصول على الدعم لمشاكل Aspose.PDF؟

يمكنك طلب المساعدة من منتدى دعم Asposeهنا.

هل هناك أية قيود على النسخة التجريبية المجانية؟

نعم، قد يكون للإصدار التجريبي بعض القيود، مثل وضع علامة مائية على المستندات المولدة. للحصول على الوظائف الكاملة، فكر في الحصول على ترخيص مؤقتهنا.

أين يمكنني العثور على مزيد من المعلومات حول ميزات Aspose.PDF؟

يمكنك استكشاف الوثائق الشاملة المتاحةهنا.