تصدير بيانات ورقة عمل Excel إلى جدول

مقدمة

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

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

قبل أن نتعمق في الترميز، دعونا نقوم بإعداد بعض الأشياء:

  1. Aspose.PDF for .NET Library – تأكد من تثبيت أحدث إصدار. يمكنكتحميله هنا.
  2. Aspose.Cells for .NET Library – ستحتاج إليها للتعامل مع عمليات Excel. قم بتنزيلها منهنا.
  3. بيئة تطوير .NET – أداة مثل Visual Studio ستعمل بشكل مثالي للترميز.
  4. ملف Excel – قم بإعداد ملف Excel الذي يحتوي على البيانات التي تريد تصديرها.

إذا لم يكن لديك مكتبات Aspose.PDF وAspose.Cells، فيمكنك البدء بـنسخة تجريبية مجانية.

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

للبدء، تأكد من تثبيت مكتبتي Aspose.PDF وAspose.Cells في مشروعك. يمكنك تثبيتهما باستخدام NuGet Package Manager في Visual Studio.

فيما يلي كيفية استيراد الحزم اللازمة في كود C# الخاص بك:

using System.Data;
using System.IO;
using System.Linq;

الآن بعد أن تم تحديد المتطلبات الأساسية، دعنا ننتقل إلى عملية تصدير البيانات من ورقة Excel إلى جدول في مستند PDF.

الخطوة 1: تحميل مصنف Excel

للبدء، تحتاج إلى تحميل مصنف Excel الخاص بك إلى البرنامج. في هذه الخطوة، سنستخدم Aspose.Cells لفتح ملف Excel.

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// تحميل مصنف Excel
Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(new FileStream(dataDir + "newBook1.xlsx", FileMode.Open));

الشرح: هنا، نحدد مسار الدليل الذي يوجد به ملف Excel الخاص بنا ونقوم بتحميل المصنف باستخدامAspose.Cells.Workbook . تأكد من التعديل"YOUR DOCUMENT DIRECTORY" للإشارة إلى موقع ملفك.

الخطوة 2: الوصول إلى ورقة العمل الأولى

بعد تحميل المصنف، نحتاج إلى الوصول إلى ورقة العمل الأولى التي يتم تخزين بياناتنا فيها.

// الوصول إلى ورقة العمل الأولى في ملف Excel
Aspose.Cells.Worksheet worksheet = workbook.Worksheets[0];

التوضيح: هذه الخطوة واضحة ومباشرة - نأخذ ورقة العمل الأولى من المصنف، والتي تحتوي على البيانات المراد تصديرها.

الخطوة 3: تصدير البيانات إلى جدول البيانات

الآن، دعنا نقوم بتصدير البيانات من ورقة Excel إلى كائن DataTable، والذي سيعمل كوسيط لنقل البيانات إلى ملف PDF.

// تصدير محتويات 7 صفوف و 2 عمودين بداية من الخلية الأولى إلى DataTable
DataTable dataTable = worksheet.Cells.ExportDataTable(0, 0, worksheet.Cells.MaxRow + 1, worksheet.Cells.MaxColumn + 1, true);

الشرح:ExportDataTable تستخرج الطريقة البيانات بدءًا من الخلية الأولى في ورقة العمل وتمتد إلى جميع الصفوف والأعمدة. ثم يتم تخزين هذه البيانات فيDataTable لمزيد من الاستخدام.

الخطوة 4: إنشاء مستند PDF جديد

بعد ذلك، نحتاج إلى إنشاء مستند PDF جديد باستخدام Aspose.PDF.

// إنشاء مثيل مستند
Aspose.Pdf.Document pdfDocument = new Aspose.Pdf.Document();

// إنشاء صفحة في مثيل المستند
Aspose.Pdf.Page page = pdfDocument.Pages.Add();

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

الخطوة 5: إنشاء كائن جدول في PDF

لننتقل الآن إلى إنشاء جدول داخل مستند PDF.

// إنشاء كائن جدول
Aspose.Pdf.Table table = new Aspose.Pdf.Table();

// أضف كائن الجدول إلى مجموعة الفقرات في الصفحة
page.Paragraphs.Add(table);

الشرح: نقوم بإنشاءAspose.Pdf.Table الكائن وإضافته إلى مجموعة الفقرات الخاصة بالصفحة، مما يضمن عرض الجدول على الصفحة.

الخطوة 6: تعيين عرض الأعمدة والحدود

تحتاج الجداول في ملف PDF إلى عرض أعمدة محدد. وسنضيف أيضًا حدودًا لجعل الجدول أكثر قابلية للقراءة.

// تعيين عرض الأعمدة في الجدول
table.ColumnWidths = "40 100 100";

// تعيين حدود الخلية الافتراضية
table.DefaultCellBorder = new Aspose.Pdf.BorderInfo(Aspose.Pdf.BorderSide.All, 0.1F);

الشرح: نقوم بتعيين عرض الأعمدة الثلاثة ونعطي جميع الخلايا حدودًا افتراضية بسُمك0.1F.

الخطوة 7: استيراد البيانات من جدول البيانات إلى جدول PDF

الآن، حان الوقت لاستيراد البيانات من جدول البيانات إلى جدول PDF الخاص بنا.

// استيراد البيانات إلى كائن الجدول من جدول البيانات
table.ImportDataTable(dataTable, true, 0, 0, dataTable.Rows.Count + 1, dataTable.Columns.Count);

الشرح:ImportDataTableالطريقة تنقل جميع البيانات منDataTable إلى جدول PDF. يؤدي هذا إلى ملء الجدول بالبيانات من ورقة Excel الخاصة بك.

الخطوة 8: تصميم صف الرأس

دعونا نقوم بتصميم صف رأس الجدول عن طريق تغيير لون الخلفية والخط والمحاذاة.

// احصل على الصف الأول من الجدول
Aspose.Pdf.Row headerRow = table.Rows[0];

// تعيين التصميم لصف الرأس
foreach (Aspose.Pdf.Cell cell in headerRow.Cells)
{
    cell.BackgroundColor = Color.Blue;
    cell.DefaultCellTextState.Font = Aspose.Pdf.Text.FontRepository.FindFont("Helvetica-Oblique");
    cell.DefaultCellTextState.ForegroundColor = Color.Yellow;
    cell.DefaultCellTextState.HorizontalAlignment = Aspose.Pdf.HorizontalAlignment.Center;
}

التوضيح: نقوم بالمرور على جميع الخلايا في الصف الأول (الرأس) ونضبط لون خلفيتها إلى اللون الأزرق، ولون النص إلى اللون الأصفر، ونقوم بمحاذاة النص إلى المركز.

الخطوة 9: تصميم الصفوف المتبقية

للتمييز بين الرأس وبقية الصفوف، دعنا نضيف نمطًا مختلفًا للصفوف المتبقية.

for (int i = 1; i <= dataTable.Rows.Count; i++)
{
    foreach (Aspose.Pdf.Cell cell in table.Rows[i].Cells)
    {
        cell.BackgroundColor = Color.Gray;
        cell.DefaultCellTextState.ForegroundColor = Color.White;
    }
}

التوضيح: بالنسبة لجميع الصفوف باستثناء الرأس، قمنا بتعيين خلفية رمادية ولون نص أبيض.

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

وأخيرًا، احفظ مستند PDF الذي يحتوي على الجدول.

// احفظ ملف PDF
pdfDocument.Save(dataDir + "Exceldata_toPdf_table.pdf");

الشرح: نقوم بحفظ ملف PDF في الدليل المحدد. ها هي بيانات Excel الخاصة بك موجودة الآن داخل جدول PDF بتنسيق جميل.

خاتمة

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

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

هل يمكنني تخصيص الجدول أكثر؟

بالتأكيد! يمكنك تعديل الألوان والخطوط والمحاذاة وحتى إضافة حدود لخلايا معينة.

هل Aspose.PDF لـ .NET مجاني؟

إنه يقدم نسخة تجريبية مجانية، ولكن للاستخدام الموسع، ستحتاج إلى ترخيص. يمكنكاشتريه هنا.

هل يمكنني تصدير صفوف وأعمدة محددة فقط؟

نعم، يمكنك تعديل المعلمات فيExportDataTable طريقة لتصدير نطاقات محددة.

هل يعمل هذا مع ملفات Excel الكبيرة؟

نعم، تم تصميم Aspose.Cells للتعامل مع ملفات Excel الكبيرة بكفاءة.

كيف يمكنني إضافة المزيد من الصفحات إلى ملف PDF؟

يمكنك استخدامpdfDocument.Pages.Add() لإضافة عدد الصفحات الذي تحتاجه.

تحديد فاصل الجدول في ملف PDF استخراج الحدود في ملف PDF