استيراد البيانات في صفحة العمل
كيفية استيراد البيانات إلى ورقة العمل
عند فتح ملف Excel بـ Aspose.Cells ، يتم استيراد جميع البيانات في الملف تلقائيًا. يمكن لـ Aspose.Cells أيضًا استيراد البيانات من مصادر بيانات أخرى.
توفر Aspose.Cells فئة تمثل ملف Microsoft Excel. تحتوي الفئة على مجموعة تسمح بالوصول إلى كل ورقة عمل في ملف Excel. يتم تمثيل ورقة العمل بواسطة الفئة. توفر الفئة مجموعة. توفر مجموعة وسائل مفيدة لاستيراد البيانات من مصادر بيانات مختلفة. يشرح هذا المقال كيف يمكن استخدام هذه الأساليب.
كيفية استيراد البيانات إلى Excel باستخدام واجهة ICellsDataTable
نفذ ICellsDataTable لتغليف مصادر البيانات المختلفة لديك، ثم استخدم Cells.ImportData() لاستيراد البيانات إلى ورقة العمل في Excel.
الكود المثالي
يتم تقديم تنفيذ CustomerDataSource, Customer, و CustomerList للفئات أدناه
كيفية استيراد البيانات إلى Excel من مصفوفة
لِاستيراد البيانات إلى ورقة العمل من مصفوفة، اُنادي بطريقة ImportArray في مجموعة Cells. يوجد العديد من الإصدارات المحملة للدالة ImportArray ولكن الشحصة الصارية تأخذ المعاملات التالية:
- مصفوفة، الكائن مصفوفة الذي تقوم باستيراد المحتوى منه.
- رقم الصف، رقم الصف الذي سيتم استيراد البيانات إليه.
- رقم العمود، رقم العمود الذي سيتم استيراد البيانات إليه.
- هَلْ رأسيّ، قيمة بولية تحدد ما إذا كنت ستقوم استيراد البيانات عموديًا أو أفقيًا.
كيفية استيراد البيانات إلى Excel من ArrayList
لِاستيراد البيانات من ArrayList إلى ورقات العمل، اُنادي بطريقة Cells في مجموعة ImportArrayList. تأخذ طريقة ImportArray المعاملات التالية:
- ArrayList، تمثل كائن ArrayList الذي تقوم بإستيراده.
- رقم الصف، تمثل رقم الصف الأول الذي سيتم استيراد البيانات إليه.
- رقم العمود، تمثل رقم العمود الأول الذي سيتم استيراد البيانات إليه.
- هَلْ رأسيّ، قيمة بولية تحدد ما إذا كنت ستقوم استيراد البيانات عموديًا أو أفقيًا.
كيفية استيراد البيانات إلى Excel من الكائنات المخصصة
للاستيراد البيانات من مجموعة من الكائنات إلى ورقة العمل، استخدم ImportCustomObjects. قدم قائمة من الأعمدة/الخصائص إلى الطريقة لعرض قائمة الكائنات المرغوبة الخاصة بك.
كيفية استيراد البيانات إلى إكسل من الكائنات المخصصة وفحص منطقة الدمج
للاستيراد البيانات من مجموعة من الكائنات إلى ورقة العمل التي تحتوي على خلايا مدمجة، استخدم خاصية ImportTableOptions.CheckMergedCells. إذا كان القالب في إكسل يحتوي على خلايا مدمجة، ضبط قيمة الخاصية ImportTableOptions.CheckMergedCells على القيمة الصحيحة. قم بتمرير الكائن ImportTableOptions إلى جانب قائمة الأعمدة/الخصائص إلى الطريقة لعرض قائمة الكائنات المرغوبة الخاصة بك. يوضح الكود العيني التالي استخدام الخاصية ImportTableOptions.CheckMergedCells لاستيراد البيانات من الكائنات المخصصة إلى الخلايا المدمجة. يرجى الرجوع إلى الملف الإكسل المرفق للمرجعية source Excel وملف الإكسل الناتج output Excel.
كيفية استيراد البيانات إلى إكسل من DataTable
للاستيراد البيانات من DataTable، اتصل بال Cells الخاص بمجموعة ImportDataTable. هناك العديد من النسخ المتعددة من الطريقة ImportDataTable ولكن النسخة النمطية تأخذ معلمات الدخول التالية:
- جدول البيانات، كائن DataTable الذي تستورد محتواه منه.
- هل يتم عرض اسم الحقل، يحدد ما إذا كانت أسماء أعمدة DataTable يجب استيرادها إلى ورقة العمل كصف أول أم لا.
- خلية البداية, يمثل اسم الخلية البداية (على سبيل المثال “A1”) من حيث يجب استيراد محتويات DataTable.
كيفية استيراد البيانات إلى إكسل من كائن ديناميكي كمصدر بيانات
توفر Aspose.Cells ميزات للعمل مع الكائنات الديناميكية كمصدر بيانات. يساعد في استخدام مصدر بيانات حيث يتم إضافة الخصائص بشكل ديناميكي إلى الكائنات. بمجرد إضافة الخصائص إلى الكائن، تعتبر Aspose.Cells الإدخال الأول كالقالب وتتعامل بشكل مناسب مع البقية. يعني إذا تمت إضافة خاصية ديناميكية إلى العنصر الأول فقط وليس إلى الكائنات الأخرى، تعتبر Aspose.Cells أن جميع العناصر في المجموعة يجب أن تكون متماثلة.
في هذا المثال، يتم استخدام نموذج قالب يحتوي في البداية على متغيرين فقط. يتم تحويل هذه القائمة إلى قائمة من الكائنات الديناميكية. ثم يتم إضافة بعض الحقول الإضافية إليها وأخيرا تحميلها في مصنف البيانات. يقوم المصنف بأخذ القيم الخاصة بالقالب XLSX فقط. يستخدم مصنف القالب علامات Smart Markers التي تحتوي أيضا على معلمات. تسمح المعلمات لك بتعديل كيفية تخطيط المعلومات. يمكن الحصول على تفاصيل حول علامات Smart Markers من المقالة التالية:
كيفية استيراد DataColumn إلى إكسل
يتكون كائن DataTable أو DataView من عمود واحد أو أكثر. يمكن للمطورين أيضًا استيراد البيانات من أي عمود/أعمدة من DataTable أو DataView عن طريق استدعاء ImportData في مجموعة Cells. الطريقة ImportData تقبل معلمة من نوع ImportTableOptions. توفر الفئة ImportTableOptions خاصية ColumnIndexes تقبل مصفوفة من مؤشرات الأعمدة.
يقدم الكود العيني أدناه استخدام ImportTableOptions.ColumnIndexes لاستيراد الأعمدة الانتقائية.
كيفية استيراد DataView إلى إكسل
للاستيراد البيانات من DataView، اتصل بال Cells الخاص بمجموعة ImportData. هناك العديد من النسخ المتعددة من الطريقة ImportData ولكن النسخة لـ DataView تأخذ المعلمات التالية:
- DataView: ال DataView الذي تعتزم استيراد المحتوى منه.
- الصف الأول: رقم الصف الذي سيتم استيراد البيانات إليه.
- العمود الأول: رقم العمود الذي سيتم استيراد البيانات إليه.
- خيارات جدول الاستيراد: خيارات الاستيراد.
كيفية استيراد DataGrid إلى Excel
من الممكن استيراد البيانات من DataGrid عن طريق استدعاء الأسلوب ImportDataGrid في مجموعة Cells. هناك العديد من الإصدارات المتعددة للأسلوب ImportDataGrid ولكن الإصدار النمطي يأخذ المعلمات التالية:
- جدول البيانات، كائن DataGrid الذي تقوم باستيراد المحتوى منه.
- رقم الصف، رقم الصف للخلية الأولى التي سيتم استيراد البيانات إليها.
- رقم العمود، رقم العمود للخلية الأولى التي سيتم استيراد البيانات إليها.
- إدراج الصفوف، خاصية بوليانية تشير ما إذا كان يجب إضافة صفوف إضافية إلى ورقة العمل لتناسب البيانات أم لا.
كيفية استيراد GridView إلى Excel
لتستيراد البيانات من عنصر GridView، اِستدعِ ImportGridView في مجموعة Cells.
تسمح Aspose.Cells لنا بالاحترام للقيم المهيئة بتنسيق HTML أثناء استيراد البيانات إلى جدول البيانات. عند تمكين تحليل HTML أثناء استيراد البيانات، يحول Aspose.Cells ال HTML إلى تنسيق الخلية المقابل.
كيفية استيراد البيانات المهيئة بتنسيق HTML إلى Excel
توفر Aspose.Cells فئة Cells توفر طرقًا مفيدة جدًا لاستيراد البيانات من مصادر بيانات خارجية. يوضح هذا المقال كيفية تحليل النص المهيئ بتنسيق HTML أثناء استيراد البيانات وتحويل HTML إلى قيم خلية مهيئة.
كيفية استيراد البيانات إلى Excel من JSON
توفر Aspose.Cells فئة JsonUtility لمعالجة JSON. تحتوي فئة JsonUtility على أسلوب ImportData لاستيراد بيانات JSON. كما توفر Aspose.Cells أيضًا فئة JsonLayoutOptions تمثل خيارات تخطيط JSON. يقبل الأسلوب ImportData JsonLayoutOptions كمعلمة. توفر الفئة JsonLayoutOptions الخصائص التالية.
- ArrayAsTable: يشير ما إذا كان يجب معالجة الصف في مصفوفة كجدول أم لا.
- ConvertNumericOrDate: يحصل أو يعين قيمة تشير ما إذا كان يجب تحويل السلسلة في JSON إلى رقم أو تاريخ.
- DateFormat: يحصل ويضبط تنسيق قيمة التاريخ.
- IgnoreArrayTitle: يشير ما إذا كان يجب تجاهل العنوان إذا كانت خاصية الكائن مصفوفة
- IgnoreNull: يشير ما إذا كان يجب تجاهل قيمة الـ Null أم لا.
- IgnoreObjectTitle: يشير ما إذا كان يجب تجاهل العنوان إذا كانت خاصية الكائن هي كائن.
- NumberFormat: يحصل ويضبط تنسيق القيمة الرقمية.
- TitleStyle: يحصل ويضبط نمط العنوان.
الكود النموذجي الذي يوضح الاستخدام الأسفل للفئتين JsonUtility و JsonLayoutOptions لاستيراد بيانات JSON.