BuildReport

BuildReport(Document, object)

Remplit le document modèle spécifié avec les données de la source spécifiée, ce qui en fait un rapport prêt.

public bool BuildReport(Document document, object dataSource)
ParamètreTaperLa description
documentDocumentUn modèle de document à remplir avec des données.
dataSourceObjectUn objet source de données.

Return_Value

Un indicateur indiquant si l’analyse du document modèle a réussi. L’indicateur renvoyé n’a de sens que si une valeur deOptions la propriété comprend leInlineErrorMessages option.

Remarques

Grâce à cette surcharge, vous pouvez référencer les membres de la source de données dans le document modèle, mais vous ne pouvez pas référencer l’objet source de données lui-même. Vous devez utiliser la commandeBuildReport surcharge pour y parvenir.

Un objet source de données peut être de l’un des types suivants :

Pour plus d’informations sur la façon de travailler avec des sources de données de différents types dans des documents de modèle, consultez la référence de syntaxe de modèle (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Voir également

BuildReport(Document, object, string)

Remplit le document modèle spécifié avec les données de la source spécifiée, ce qui en fait un rapport prêt.

public bool BuildReport(Document document, object dataSource, string dataSourceName)
ParamètreTaperLa description
documentDocumentUn modèle de document à remplir avec des données.
dataSourceObjectUn objet source de données.
dataSourceNameStringUn nom pour référencer l’objet source de données dans le modèle.

Return_Value

Un indicateur indiquant si l’analyse du document modèle a réussi. L’indicateur renvoyé n’a de sens que si une valeur deOptions la propriété comprend leInlineErrorMessages option.

Remarques

En utilisant cette surcharge, vous pouvez référencer les membres de la source de données et l’objet source de données lui-même dans le modèle. Si vous n’allez pas référencer l’objet source de données lui-même, vous pouvez omettredataSourceName passantnul ou utilisez leBuildReport surcharge.

Un objet source de données peut être de l’un des types suivants :

Pour plus d’informations sur la façon de travailler avec des sources de données de différents types dans des documents de modèle, consultez la référence de syntaxe de modèle (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Exemples

Montre comment autoriser les membres manquants.

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

Montre comment supprimer des paragraphes de manière sélective.

// Le modèle contient des balises avec un point d'exclamation. Pour ces balises, les paragraphes vides seront supprimés.
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");

Montre comment afficher les valeurs sous forme de texte en dollars.

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

Voir également

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

Remplit le document modèle spécifié avec les données des sources spécifiées, ce qui en fait un rapport prêt.

public bool BuildReport(Document document, object[] dataSources, string[] dataSourceNames)
ParamètreTaperLa description
documentDocumentUn modèle de document à remplir avec des données.
dataSourcesObject[]Un tableau d’objets de source de données.
dataSourceNamesString[]Un tableau de noms pour référencer les objets de source de données dans le modèle.

Return_Value

Un indicateur indiquant si l’analyse du document modèle a réussi. L’indicateur renvoyé n’a de sens que si une valeur deOptions la propriété comprend leInlineErrorMessages option.

Remarques

En utilisant cette surcharge, vous pouvez référencer plusieurs objets de source de données et leurs membres dans le modèle. Le nom de la première source de données peut être omis (c’est-à-dire être une chaîne vide ounul Si vous référencez les membres de la source de données, mais pas l’objet source lui-même, les noms des autres sources de données doivent être spécifiés et uniques.

Si vous envisagez d’utiliser une seule source de données, pensez à utiliserBuildReport etBuildReport surcharges à la place.

Un objet source de données peut être de l’un des types suivants :

Pour plus d’informations sur la façon de travailler avec des sources de données de différents types dans des documents de modèle, consultez la référence de syntaxe de modèle (https://docs.aspose.com/display/wordsnet/Template+Syntax).

Exemples

Montre comment travailler avec des graphiques à partir de 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");

Montre comment conserver la numérotation insérée telle quelle.

// Par défaut, les listes numérotées d'un document modèle sont continuées lorsque leurs identifiants correspondent à ceux d'un document en cours d'insertion.
// Avec "-sourceNumbering", la numérotation doit être séparée et conservée telle quelle.
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");

Voir également

ReportingEngine.Options ReportingEngine.GetHashCode