BuildReport

BuildReport(Document, object)

Füllt das angegebene Vorlagendokument mit Daten aus der angegebenen Quelle und macht daraus einen fertigen Bericht.

public bool BuildReport(Document document, object dataSource)
ParameterTypBeschreibung
documentDocumentEin Vorlagendokument, das mit Daten gefüllt werden soll.
dataSourceObjectEin Datenquellenobjekt.

Rückgabewert

Ein Flag, das angibt, ob das Parsen des Vorlagendokuments erfolgreich war. Das zurückgegebene Flag ist nur dann sinnvoll, wenn ein Wert desOptions Eigenschaft enthält dieInlineErrorMessages Option.

Bemerkungen

Mit dieser Überladung können Sie die Elemente der Datenquelle im Vorlagendokument referenzieren, aber nicht auf das Datenquellenobjekt selbst. Sie sollten dieBuildReport Überladung, um dies zu erreichen.

Ein Datenquellenobjekt kann einen der folgenden Typen haben:

Informationen zum Arbeiten mit Datenquellen unterschiedlichen Typs in Vorlagendokumenten finden Sie in der Referenz zur Vorlagensyntax (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Siehe auch

BuildReport(Document, object, string)

Füllt das angegebene Vorlagendokument mit Daten aus der angegebenen Quelle und macht daraus einen fertigen Bericht.

public bool BuildReport(Document document, object dataSource, string dataSourceName)
ParameterTypBeschreibung
documentDocumentEin Vorlagendokument, das mit Daten gefüllt werden soll.
dataSourceObjectEin Datenquellenobjekt.
dataSourceNameStringEin Name zum Verweisen auf das Datenquellenobjekt in der Vorlage.

Rückgabewert

Ein Flag, das angibt, ob das Parsen des Vorlagendokuments erfolgreich war. Das zurückgegebene Flag ist nur dann sinnvoll, wenn ein Wert desOptions Eigenschaft enthält dieInlineErrorMessages Option.

Bemerkungen

Mit dieser Überladung können Sie in der Vorlage auf die Mitglieder der Datenquelle und das Datenquellenobjekt selbst verweisen. Wenn Sie nicht auf das Datenquellenobjekt selbst verweisen, können Sie Folgendes weglassen:dataSourceName vorbeinull oder verwenden Sie dieBuildReport Überlastung.

Ein Datenquellenobjekt kann einen der folgenden Typen haben:

Informationen zum Arbeiten mit Datenquellen unterschiedlichen Typs in Vorlagendokumenten finden Sie in der Referenz zur Vorlagensyntax (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Beispiele

Zeigt, wie fehlende Mitglieder zugelassen werden.

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(), "");

Zeigt, wie Absätze selektiv entfernt werden.

// Die Vorlage enthält Tags mit einem Ausrufezeichen. Bei solchen Tags werden leere Absätze entfernt.
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");

Zeigt, wie Werte als Dollartext angezeigt werden.

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");

Siehe auch

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

Füllt das angegebene Vorlagendokument mit Daten aus den angegebenen Quellen und macht daraus einen fertigen Bericht.

public bool BuildReport(Document document, object[] dataSources, string[] dataSourceNames)
ParameterTypBeschreibung
documentDocumentEin Vorlagendokument, das mit Daten gefüllt werden soll.
dataSourcesObject[]Ein Array von Datenquellenobjekten.
dataSourceNamesString[]Ein Array von Namen zum Verweisen auf die Datenquellenobjekte innerhalb der Vorlage.

Rückgabewert

Ein Flag, das angibt, ob das Parsen des Vorlagendokuments erfolgreich war. Das zurückgegebene Flag ist nur dann sinnvoll, wenn ein Wert desOptions Eigenschaft enthält dieInlineErrorMessages Option.

Bemerkungen

Mit dieser Überladung können Sie mehrere Datenquellenobjekte und deren Mitglieder in der Vorlage referenzieren. Der Name der ersten Datenquelle kann weggelassen werden (d. h. eine leere Zeichenfolge sein odernull), wenn Sie auf die Mitglieder der Datenquelle verweisen, nicht aber auf das Datenquellenobjekt selbst. Die Namen der anderen Datenquellen müssen angegeben und eindeutig sein.

Wenn Sie eine einzelne Datenquelle verwenden, sollten Sie die Verwendung vonBuildReport undBuildReport stattdessen Überladungen.

Ein Datenquellenobjekt kann einen der folgenden Typen haben:

Informationen zum Arbeiten mit Datenquellen unterschiedlichen Typs in Vorlagendokumenten finden Sie in der Referenz zur Vorlagensyntax (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Beispiele

Zeigt, wie man mit Diagrammen aus Word 2016 arbeitet.

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");

Zeigt, wie die eingefügte Nummerierung unverändert bleibt.

// Standardmäßig werden nummerierte Listen aus einem Vorlagendokument fortgesetzt, wenn ihre Bezeichner mit denen aus einem eingefügten Dokument übereinstimmen.
// Mit „-sourceNumbering“ soll die Nummerierung getrennt und so belassen werden, wie sie ist.
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");

Siehe auch

ReportingEngine.Options ReportingEngine.GetHashCode