BuildReport

BuildReport(Document, object)

يملأ مستند القالب المحدد بالبيانات من المصدر المحدد مما يجعله تقريرًا جاهزًا.

public bool BuildReport(Document document, object dataSource)
معامليكتبوصف
documentDocumentمستند نموذجي ليتم ملؤه بالبيانات.
dataSourceObjectكائن مصدر البيانات.

قيمة الإرجاع

علم يشير إلى ما إذا كان تحليل مستند القالب ناجحًا أم لا. العلم الذي تم إرجاعه يكون منطقيًا فقط إذا كانت قيمةOptions تتضمن الخاصية InlineErrorMessages خيار.

ملاحظات

باستخدام هذا التحميل الزائد، يمكنك الرجوع إلى عناصر مصدر البيانات في مستند القالب، ولكن لا يمكنك الرجوع إلى كائن مصدر البيانات نفسه. يجب عليك استخدامBuildReport التحميل الزائد لتحقيق ذلك.

يمكن أن يكون كائن مصدر البيانات من أحد الأنواع التالية:

للحصول على معلومات حول كيفية العمل مع مصادر البيانات من أنواع مختلفة في مستندات القالب، راجع مرجع بناء جملة القالب (https://docs.aspose.com/display/wordsnet/Template+Syntax).

أنظر أيضا

BuildReport(Document, object, string)

يملأ مستند القالب المحدد بالبيانات من المصدر المحدد مما يجعله تقريرًا جاهزًا.

public bool BuildReport(Document document, object dataSource, string dataSourceName)
معامليكتبوصف
documentDocumentمستند نموذجي ليتم ملؤه بالبيانات.
dataSourceObjectكائن مصدر البيانات.
dataSourceNameStringاسم للإشارة إلى كائن مصدر البيانات في القالب.

قيمة الإرجاع

علم يشير إلى ما إذا كان تحليل مستند القالب ناجحًا أم لا. العلم الذي تم إرجاعه يكون منطقيًا فقط إذا كانت قيمةOptions تتضمن الخاصية InlineErrorMessages خيار.

ملاحظات

باستخدام هذا التحميل الزائد، يمكنك الرجوع إلى أعضاء مصدر البيانات وكائن مصدر البيانات نفسه في القالب. إذا كنت لن تشير إلى كائن مصدر البيانات نفسه، فيمكنك حذفهdataSourceName يمرباطل أو استخدمBuildReport التحميل الزائد.

يمكن أن يكون كائن مصدر البيانات من أحد الأنواع التالية:

للحصول على معلومات حول كيفية العمل مع مصادر البيانات من أنواع مختلفة في مستندات القالب، راجع مرجع بناء جملة القالب (https://docs.aspose.com/display/wordsnet/Template+Syntax).

أمثلة

يوضح كيفية السماح للأعضاء المفقودين.

DocumentBuilder builder = new DocumentBuilder();
builder.Writeln("<<[missingObject.First().id]>>");
builder.Writeln("<<foreach [in missingObject]>><<[id]>><</foreach>>");

ReportingEngine engine = new ReportingEngine { Options = ReportBuildOptions.AllowMissingMembers };
engine.MissingMemberMessage = "Missed";
engine.BuildReport(builder.Document, new DataSet(), "");

يوضح كيفية إزالة الفقرات بشكل انتقائي.

// يحتوي القالب على علامات تعجب. ستُحذف الفقرات الفارغة من هذه العلامات.
Document doc = new Document(MyDir + "Reporting engine template - Selective remove paragraphs.docx");

ReportingEngine engine = new ReportingEngine();
engine.BuildReport(doc, false, "value");

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

يوضح كيفية عرض القيم كنص بالدولار.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("<<[ds.Value1]:dollarText>>\r<<[ds.Value2]:dollarText>>");

NumericTestClass testData = new NumericTestBuilder().WithValues(1234, 5621718.589).Build();

ReportingEngine report = new ReportingEngine();
report.KnownTypes.Add(typeof(NumericTestClass));
report.BuildReport(doc, testData, "ds");

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

أنظر أيضا

BuildReport(Document, object[], string[])

يملأ مستند القالب المحدد بالبيانات من المصادر المحددة مما يجعله تقريرًا جاهزًا.

public bool BuildReport(Document document, object[] dataSources, string[] dataSourceNames)
معامليكتبوصف
documentDocumentمستند نموذجي ليتم ملؤه بالبيانات.
dataSourcesObject[]مجموعة من كائنات مصدر البيانات.
dataSourceNamesString[]مجموعة من الأسماء للإشارة إلى كائنات مصدر البيانات داخل القالب.

قيمة الإرجاع

علم يشير إلى ما إذا كان تحليل مستند القالب ناجحًا أم لا. العلم الذي تم إرجاعه يكون منطقيًا فقط إذا كانت قيمةOptions تتضمن الخاصية InlineErrorMessages خيار.

ملاحظات

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

إذا كنت ستستخدم مصدر بيانات واحد، ففكر في استخدامBuildReport وBuildReport التحميل الزائد بدلا من ذلك.

يمكن أن يكون كائن مصدر البيانات من أحد الأنواع التالية:

للحصول على معلومات حول كيفية العمل مع مصادر البيانات من أنواع مختلفة في مستندات القالب، راجع مرجع بناء جملة القالب (https://docs.aspose.com/display/wordsnet/Template+Syntax).

أمثلة

يوضح كيفية العمل مع المخططات البيانية من word 2016.

Document doc = new Document(MyDir + "Reporting engine template - Word 2016 Charts.docx");

ReportingEngine engine = new ReportingEngine();
engine.BuildReport(doc, new object[] { Common.GetShares(), Common.GetShareQuotes() },
    new string[] { "shares", "quotes" });

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

يوضح كيفية الاحتفاظ بالترقيم المدرج كما هو.

// بشكل افتراضي، تستمر القوائم المرقمة من مستند القالب عندما تتطابق معرفاتها مع تلك الموجودة في المستند الذي يتم إدراجه.
// باستخدام "-sourceNumbering" يجب فصل الترقيم والاحتفاظ به كما هو.
Document template = DocumentHelper.CreateSimpleDocument("<<doc [src.Document]>>" + Environment.NewLine + "<<doc [src.Document] -sourceNumbering>>");

DocumentTestClass doc = new DocumentTestBuilder()
    .WithDocument(new Document(MyDir + "List item.docx")).Build();

ReportingEngine engine = new ReportingEngine() { Options = ReportBuildOptions.RemoveEmptyParagraphs };
engine.BuildReport(template, new object[] { doc }, new[] { "src" });

template.Save(ArtifactsDir + "ReportingEngine.SourseListNumbering.docx");

أنظر أيضا

ReportingEngine.Options ReportingEngine.GetHashCode