نسخ البيانات داخل مصنف Excel باستخدام Aspose.Cells لـ .NET

مقدمة

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

المتطلبات الأساسية لنسخ البيانات في Excel باستخدام Aspose.Cells

قبل الخوض في عملية الترميز، دعنا نتأكد من أن كل شيء في مكانه الصحيح:

1. مكتبة Aspose.Cells for .NET: يجب أن يكون لديك مكتبة Aspose.Cells for .NET مثبتة. يمكنك تنزيل أحدث إصدار منصفحة تنزيل Aspose.Cells لـ .NET.
2. بيئة التطوير: تعد بيئة التطوير المتكاملة المتوافقة مع .NET مثل Visual Studio ضرورية لكتابة التعليمات البرمجية وتشغيلها.
3. ترخيص Aspose: يمكنك استخدام إصدار تجريبي مجاني أو ترخيص تم شراؤه. لمزيد من المعلومات، تفضل بزيارةهنا.

بمجرد تعيين المتطلبات الأساسية، ستكون جاهزًا لبدء العمل مع المكتبة.

استيراد الحزم المطلوبة

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

using System.IO;
using Aspose.Cells;
using System;

ستتيح لك هذه المساحات الاسمية الوصول إلىWorkbook الفئة (للعمل مع ملفات Excel) وWorksheetCollection (للوصول إلى أوراق متعددة داخل مصنف).

الخطوة 1: تهيئة مسارات الملفات للمصنف

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

// قم بتحديد مسار الدليل الذي يتواجد فيه ملف Excel.
string dataDir = "Your Directory Path";

// قم بتحديد المسار الكامل إلى مصنف الإدخال.
string inputPath = dataDir + "book1.xls";

يستبدل"Your Directory Path" مع المسار الفعلي إلى الدليل الذي يحتوي على المصنف. يساعد هذا في ضمان مرونة الكود وإمكانية إدارة المسارات بشكل فعال.

الخطوة 2: افتح المصنف للوصول إلى البيانات

الآن بعد تعيين مسارات الملفات، فإن الخطوة التالية هي تحميل مصنف Excel إلىWorkbook الكائن. يسمح لك هذا بالوصول إلى محتوياته للتلاعب بها.

// قم بتحميل ملف Excel إلى كائن المصنف.
Workbook wb = new Workbook(inputPath);

مع هذا الخط، قمت بالتحميل بنجاحbook1.xls الى داخلwb الكائن، مما يجعل بياناته متاحة.

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

بمجرد تحميل المصنف، يمكنك الوصول إلى الأوراق الموجودة فيه. يوفر Aspose.CellsWorksheetsالمجموعة التي تسمح لك بالتفاعل مع كل ورقة عمل في المصنف.

// استرداد مجموعة أوراق العمل من المصنف.
WorksheetCollection sheets = wb.Worksheets;

الsheets يتيح لك الكائن الآن الوصول إلى جميع أوراق العمل الموجودة داخلbook1.xlsويمكنك إجراء عمليات مختلفة عليها، بما في ذلك نسخ البيانات من ورقة إلى أخرى.

الخطوة 4: نسخ البيانات من ورقة إلى أخرى

لنسخ البيانات من ورقة عمل إلى أخرى داخل نفس المصنف، يوفر Aspose.Cells طريقة سهلة الاستخدام تسمىAddCopy. تعمل هذه الطريقة على إنشاء نسخة مكررة من ورقة العمل المحددة وإضافتها إلى المصنف.

// نسخ البيانات من "الورقة 1" إلى ورقة جديدة داخل المصنف.
sheets.AddCopy("Sheet1");

في هذا المثال، نقوم بنسخ البيانات من “الورقة 1” إلى ورقة جديدة.AddCopy ستقوم الطريقة بتكرار الورقة بأكملها، مع الحفاظ على كافة محتوياتها، بما في ذلك الصيغ، والتنسيق، والقيم.

الخطوة 5: احفظ المصنف المعدل

بعد نسخ البيانات، يمكنك حفظ المصنف المعدّل باسم أو موقع جديد. يتم ذلك عن طريق استدعاءSaveالطريقة علىWorkbook هدف.

//احفظ المصنف المعدّل باسم جديد.
wb.Save(dataDir + "book1_copy.xls");

سيؤدي هذا إلى حفظ المصنف الذي يحتوي على الورقة المنسوخة كـbook1_copy.xls في الدليل المحدد. يمكنك تغيير اسم الملف والمسار وفقًا لاحتياجاتك.

خاتمة

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

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

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

لا يدعم Aspose.Cells نسخ أوراق متعددة في مكالمة واحدة. ومع ذلك، يمكنك تكرار الأوراق التي تريد نسخها ونسخها بشكل فردي.

كيف يمكنني إعادة تسمية الورقة المنسوخة؟

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

sheets[sheets.Count - 1].Name = "NewSheetName";

هل Aspose.Cells متوافق مع .NET Core؟

نعم، Aspose.Cells متوافق تمامًا مع بيئتي .NET Framework و.NET Core.

كيف يتعامل Aspose.Cells مع التنسيق أثناء النسخ؟

الAddCopyتحافظ الطريقة على كافة المحتويات والتنسيقات عند نسخ الأوراق، مما يضمن أن البيانات المنسوخة تبدو متطابقة مع الأصل.

هل يمكنني نسخ ورقة إلى مصنف مختلف؟

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

sheets.Add().Copy(wb.Worksheets["Sheet1"]);