استيراد البيانات إلى ورقة العمل
استيراد البيانات إلى ورقة العمل
عند فتح ملف Excel باستخدام Aspose.Cells ، يتم استيراد كافة البيانات الموجودة في الملف تلقائيًا. يمكن Aspose.Cells أيضًا استقبال البيانات من مصادر البيانات الأخرى.
يوفر Aspose.Cells أدفتر العملفئة تمثل ملف Excel Microsoft. الدفتر العملفئة تحتوي علىأوراق عملمجموعة تسمح بالوصول إلى كل ورقة عمل في ملف Excel. يتم تمثيل ورقة العمل بواسطةورقة عمل صف دراسي. الورقة عمل فئة توفر أCellsمجموعة.Cellsيوفر التجميع طرقًا مفيدة لاستيراد البيانات من مصادر بيانات مختلفة. تشرح هذه المقالة كيف يمكن استخدام هذه الطرق.
استيراد البيانات في Excel بواجهة ICellsDataTable
ينفذICellsDataTable لالتفاف مصادر البيانات المختلفة ، ثم استخدمCells. بيانات الاستيراد () لاستيراد البيانات إلى ورقة عمل Excel.
عينة من الرموز
تنفيذCustomerDataSource, عميل، وقائمة العملاء يتم إعطاء الفئات أدناه
الاستيراد من Array
لاستيراد البيانات إلى جدول بيانات من مصفوفة ، قم باستدعاءImportArray طريقةCells مجموعة. هناك العديد من الإصدارات المحملة بشكل زائد منImportArrayطريقة ولكن الحمل الزائد النموذجي يأخذ المعلمات التالية:
- مجموعة مصفوفة، كائن المصفوفة الذي تقوم باستيراد المحتوى منه.
- رقم الصف، رقم صف الخلية الأولى التي سيتم استيراد البيانات إليها.
- رقم العمود، رقم عمود الخلية الأولى التي سيتم استيراد البيانات إليها.
- عمودي، قيمة منطقية تحدد ما إذا كان سيتم استيراد البيانات رأسيًا أو أفقيًا.
الاستيراد من ArrayList
لاستيراد البيانات من ملفArrayList لأوراق العمل ، اتصل بـCells المجموعةImportArrayListطريقة. تأخذ طريقة ImportArray المعلمات التالية:
- قائمة الصفيف ، يمثلArrayListالكائن الذي تقوم باستيراده.
- رقم الصف، يمثل رقم صف الخلية الأولى التي سيتم استيراد البيانات إليها.
- رقم العمود، يمثل رقم عمود الخلية الأولى التي سيتم استيراد البيانات إليها.
- عمودي، قيمة منطقية تحدد ما إذا كان سيتم استيراد البيانات رأسيًا أو أفقيًا.
الاستيراد من كائنات مخصصة
لاستيراد البيانات من مجموعة كائنات إلى ورقة عمل ، استخدمImportCustomObjects. قم بتوفير قائمة بالأعمدة / الخصائص للطريقة لعرض قائمة الكائنات التي تريدها.
الاستيراد من كائنات مخصصة إلى منطقة مدمجة
لاستيراد بيانات من مجموعة كائنات إلى ورقة عمل تحتوي على خلايا مدمجة ، استخدمImportTableOptions.CheckMergedCells خاصية. إذا كان قالب Excel يحتوي على خلايا مدمجة ، فقم بتعيين قيمةImportTableOptions.CheckMergedCellsالملكية على صواب. مرر الخيارات ImportTable كائن مع قائمة الأعمدة / الخصائص لطريقة عرض قائمة الكائنات التي تريدها. يوضح نموذج التعليمات البرمجية التالي استخدامImportTableOptions.CheckMergedCells لاستيراد البيانات من الكائنات المخصصة إلى الخلايا المدمجة. يرجى الاطلاع على المرفقمصدر Excel ملف والإخراج إكسل ملف كمرجع.
الاستيراد من DataTable
لاستيراد البيانات من ملفجدول البيانات ، اتصل بCells المجموعةإيمبورداتاتابلي طريقة. هناك العديد من الإصدارات المحملة بشكل زائد منإيمبورداتاتابليطريقة ولكن الحمل الزائد النموذجي يأخذ المعلمات التالية:
- جدول البيانات ، الجدول البيانات الكائن الذي تقوم باستيراد المحتوى منه.
- هو اسم الحقل المعروض ، يحدد ما إذا كانت أسماء ملفاتجدول البياناتيجب استيراد الأعمدة إلى ورقة العمل كصف أول أم لا.
- خلية البداية ، يمثل اسم خلية البداية (على سبيل المثال “A1”) من مكان استيراد محتويات ملفجدول البيانات.
الاستيراد من كائن ديناميكي كمصدر بيانات
يوفر Aspose.Cells ميزات للعمل مع العناصر الديناميكية كمصدر بيانات. يساعد في استخدام مصدر البيانات حيث تتم إضافة الخصائص ديناميكيًا إلى الكائنات. بمجرد إضافة الخصائص إلى العنصر ، يعتبر Aspose.Cells الإدخال الأول كقالب ويتعامل مع الباقي وفقًا لذلك. هذا يعني أنه إذا تمت إضافة بعض الخصائص الديناميكية إلى عنصر أول فقط وليس إلى كائنات أخرى ، فإن Aspose.Cells يعتبر أن جميع العناصر في المجموعة يجب أن تكون متطابقة.
في هذا المثال ، يتم استخدام نموذج نموذج يحتوي مبدئيًا على متغيرين فقط. يتم تحويل هذه القائمة إلى قائمة الكائنات الديناميكية. ثم يتم إضافة بعض الحقول الإضافية إليه وتحميله أخيرًا في المصنف. يختار المصنف القيم الموجودة في ملف القالب XLSX فقط. يستخدم مصنف القالب هذا العلامات الذكية التي تحتوي أيضًا على معلمات. تسمح لك المعلمات بتعديل كيفية وضع المعلومات. يمكن الحصول على تفاصيل حول العلامات الذكية من المقالة التالية:
الاستيراد من DataColumn (.NET)
أجدول البياناتأوعرض البياناتيتكون الكائن من عمود واحد أو أكثر. يمكن للمطورين أيضًا استيراد البيانات من أي عمود / أعمدة فيجدول البياناتأوعرض البياناتمن خلال استدعاءبيانات الاستيراد طريقةCellsمجموعة. البيانات الاستيرادالأسلوب يقبل معلمة من النوعخيارات ImportTable. الخيارات ImportTable فئة توفر أالعمود الفهارسالخاصية التي تقبل مصفوفة من فهارس الأعمدة.
يوضح نموذج التعليمات البرمجية الوارد أدناه استخدامImportTableOptions.ColumnIndexes لاستيراد الأعمدة الانتقائية.
الاستيراد من DataView (.NET)
لاستيراد البيانات من ملفعرض البيانات ، اتصل بCells المجموعةبيانات الاستيراد طريقة. هناك العديد من الإصدارات المحملة بشكل زائد منبيانات الاستيرادالطريقة ولكن طريقة DataView تأخذ المعلمات التالية:
- عرض البيانات: العرض البياناتالذي أنت على وشك استيراد المحتوى منه.
- **السطر الاول:**رقم صف الخلية الأولى التي سيتم استيراد البيانات إليها.
- **العمود الأول:**رقم عمود الخلية الأولى التي سيتم استيراد البيانات إليها.
- **خيارات ImportTable:**خيارات الاستيراد.
الاستيراد من DataGrid (.NET)
من الممكن استيراد البيانات من ملفشبكة بيانات من خلال استدعاءإيمبورداتاتجريد طريقةCells مجموعة. هناك العديد من الإصدارات المحملة بشكل زائد منإيمبورداتاتجريدطريقة ولكن الحمل الزائد النموذجي يأخذ المعلمات التالية:
- شبكة بيانات ، الشبكة بياناتالذي تقوم باستيراد المحتوى منه.
- رقم الصف، رقم صف الخلية الأولى التي سيتم استيراد البيانات إليها.
- رقم العمود، رقم عمود الخلية الأولى التي سيتم استيراد البيانات إليها.
- إدراج صفوف، خاصية منطقية تشير إلى ما إذا كان يجب إضافة صفوف إضافية إلى ورقة العمل لاحتواء البيانات أم لا.
الاستيراد من GridView
لاستيراد البيانات من ملفعرض شبكي السيطرة ، استدعاءإيمبورتجريدفيو طريقةCellsمجموعة.
Aspose.Cells يسمح لنا باحترام HTML القيم المنسقة أثناء استيراد البيانات إلى جدول البيانات. عند اتاحة التوزيع HTML أثناء استيراد البيانات ، يقوم Aspose.Cells بتحويل HTML إلى تنسيق الخلية المقابل.
استيراد HTML بيانات منسقة
يوفر Aspose.Cells أCellsفئة توفر طرقًا مفيدة للغاية لاستيراد البيانات من مصادر البيانات الخارجية. يوضح هذا المقال كيفية تحليل HTML نص منسق أثناء استيراد البيانات وتحويل HTML إلى قيم خلية منسقة.
استيراد البيانات من JSON
يوفر Aspose.Cells أJsonUtility فئة المعالجة JSON.JsonUtility الصف لديهبيانات الاستيراد طريقة لاستيراد بيانات JSON. يوفر Aspose.Cells أيضًا أJsonLayoutOptions فئة تمثل خيارات تخطيط JSON. البيانات الاستيرادطريقة تقبلJsonLayoutOptionsكمعامل. الJsonLayoutOptionsفئة توفر الخصائص التالية.
- ArrayAsTable: يجب معالجة الإشارات في المصفوفة كجدول أم لا.
- ConvertNumericOrDate: الحصول على أو تحديد قيمة تشير إلى ما إذا كان سيتم تحويل السلسلة في JSON إلى رقم أو تاريخ.
- صيغة التاريخ: الحصول على تنسيق قيمة التاريخ وتعيينه.
- IgnoreArrayTitle: يشير إلى ما إذا كان سيتم تجاهل العنوان إذا كانت خاصية الكائن عبارة عن مصفوفة
- تجاهل: يشير إلى ما إذا كان يجب تجاهل القيمة الخالية أم لا.
- IgnoreObjectTitle: يشير إلى ما إذا كان سيتم تجاهل العنوان إذا كانت خاصية الكائن هي كائن.
- رقم: الحصول على تنسيق القيمة الرقمية وتعيينه.
- العنوان: الحصول على نمط العنوان وتحديده.
يوضح نموذج التعليمة البرمجية أدناه استخدام ملحقJsonUtility وJsonLayoutOptions فئات لاستيراد JSON البيانات.