XmlDataSource

XmlDataSource class

يوفر الوصول إلى بيانات ملف XML أو مجرى البيانات المراد استخدامه داخل التقرير.

لمعرفة المزيد، قم بزيارةمحرك إعداد التقارير LINQ مقالة توثيقية.

public class XmlDataSource

المنشئون

اسموصف
XmlDataSource(Stream)ينشئ مصدر بيانات جديد باستخدام البيانات من مجرى XML باستخدام الخيارات الافتراضية لتحميل بيانات XML.
XmlDataSource(string)ينشئ مصدر بيانات جديد بالبيانات من ملف XML باستخدام الخيارات الافتراضية لتحميل بيانات XML.
XmlDataSource(Stream, Stream)يُنشئ مصدر بيانات جديدًا ببيانات من دفق XML باستخدام دفق تعريف مخطط XML. تُستخدم الخيارات الافتراضية لتحميل بيانات XML.
XmlDataSource(Stream, XmlDataLoadOptions)ينشئ مصدر بيانات جديد باستخدام البيانات من مجرى XML باستخدام الخيارات المحددة لتحميل بيانات XML.
XmlDataSource(string, string)يُنشئ مصدر بيانات جديد ببيانات من ملف XML باستخدام ملف تعريف مخطط XML. تُستخدم الخيارات الافتراضية لتحميل بيانات XML.
XmlDataSource(string, XmlDataLoadOptions)ينشئ مصدر بيانات جديد بالبيانات من ملف XML باستخدام الخيارات المحددة لتحميل بيانات XML.
XmlDataSource(Stream, Stream, XmlDataLoadOptions)يُنشئ مصدر بيانات جديدًا ببيانات من دفق XML باستخدام دفق تعريف مخطط XML. تُستخدم خيارات specific لتحميل بيانات XML.
XmlDataSource(string, string, XmlDataLoadOptions)يُنشئ مصدر بيانات جديدًا ببيانات من ملف XML باستخدام ملف تعريف مخطط XML. تُستخدم خيارات specific لتحميل بيانات XML.

ملاحظات

للوصول إلى بيانات الملف أو التدفق المقابل أثناء إنشاء تقرير، مرر مثيلًا لهذه الفئة as مصدر بيانات إلى أحدReportingEngine .BuildReport overloads.

في مستندات القالب، إذا كان عنصر XML من المستوى الأعلى يحتوي فقط على قائمة من العناصر من نفس النوع، XmlDataSource يجب التعامل مع المثيل بنفس الطريقة كما لو كان aDataTable مثال. وإلا،XmlDataSource يجب التعامل مع المثيل بنفس الطريقة كما لو كان aDataRow مثال . لمزيد من المعلومات، راجع مرجع بناء جملة القالب (https://docs.aspose.com/display/wordsnet/Template+Syntax).

عند تمرير تعريف مخطط XML إلى مُنشئ من هذه الفئة، تُحدَّد أنواع بيانات قيم عناصر XML البسيطة والسمات وفقًا للمخطط. لذا، في مستندات القالب، يمكنك العمل مع القيم المكتوبة (x000d) بدلاً من السلاسل النصية فقط.

عند عدم تمرير تعريف مخطط XML إلى مُنشئ هذه الفئة، تُحدَّد أنواع بيانات قيم عناصر XML البسيطة والسمات تلقائيًا بناءً على تمثيلاتها النصية. لذا، في مستندات القالب، يمكنك استخدام مع القيم المكتوبة في هذه الحالة أيضًا. يستطيع المُحرِّك التعرف تلقائيًا على قيم الأنواع التالية:

  • Nullable
  • Nullable
  • Nullable
  • Nullable
  • String

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

لتجاوز السلوك الافتراضي لتحميل بيانات XML، قم بتهيئة وتمريرXmlDataLoadOptions مثيل لمنشئ هذه الفئة.

أمثلة

إظهار كيفية استخدام XML كمصدر للبيانات (سلسلة).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

XmlDataSource dataSource = new XmlDataSource(MyDir + "List of people.xml");
BuildReport(doc, dataSource, "persons");

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataString.docx");

إظهار كيفية استخدام XML كمصدر للبيانات (دفق).

Document doc = new Document(MyDir + "Reporting engine template - XML data destination.docx");

using (FileStream stream = File.OpenRead(MyDir + "List of people.xml"))
{
    XmlDataSource dataSource = new XmlDataSource(stream);
    BuildReport(doc, dataSource, "persons");
}

doc.Save(ArtifactsDir + "ReportingEngine.XmlDataStream.docx");

أنظر أيضا

XmlDataLoadOptions Class