Řídit úroveň podrobnosti porovnání: na úrovni znaků, slov nebo odstavců.
Ten Aspose.Words LINQ Reporting Engine for .NET umožňuje vývojářům vytvářet bohaté, na datech založené zprávy spojením syntaxe značek v prostém textu s LINQ dotazy. Zprávy se mohou vázat na kolekce, databáze, JSON, XML nebo vlastní objekty, přičemž filtrování, seskupování a agregace jsou prováděny přímo v šabloně. Výsledek je plně vyplněná zpráva v formáty Word.
Instalace a nastavení
- Nainstalujte balíček NuGet
Aspose.Words. - Použijte svou licenci ( Měřené licencování ).
- Přidejte referenci na
Aspose.Wordsa zajistěte, aby byly zahrnuty závislosti. - Pro úplné kroky viz Instalační příručka .
Podporované platformy: Windows, Linux a macOS s .NET Framework, .NET nebo Mono. IDE: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.
Podporované šablony / výstupní formáty: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML a Word 2007 XML.
Quick Start
Build a Report from XML:
using Aspose.Words;
using Aspose.Words.Reporting;
var doc = new Document("ReportTemplate.docx");
var dataSource = new XmlDataSource("Data.xml");
var engine = new ReportingEngine();
engine.BuildReport(doc, dataSource, "data");
doc.Save("Report.Output.docx");Funkce a vlastnosti
Template Syntax
- Tagy jako
<<Name>>,<<foreach:Orders>>,<<if:Condition>>jsou čitelné pro člověka. - Podporováno v odstavcích, tabulkách, záhlavích a zápatích.
LINQ vazba dat
- Vázat na kolekce, DataTables, EF dotazy, JSON, XML nebo vlastní objekty.
- Vložený LINQ:
Where,OrderBy,GroupBy, projekce.
Filtrování, seskupování a řazení
- Podmíněné bloky s
<<if:…>>/<<endif>>. - Seskupit data s
<<groupby:Property>>. - Vložené řazení s
orderbyklauzule.
Agregační funkce
- Vestavěné značky:
<<sum:>>,<<avg:>>,<<count>>,<<min:>>,<<max:>>. - Automatické aktualizace při změně datových sad.
Podmíněná a přepínací logika
- Použijte
<<switch:Expression>>,<<case:Value>>,<<default>>pro více scénářů. - Zjednodušuje šablony s různými rozvrženími.
Vnořená a hierarchická data
- Procházet grafy objektů (např..,
<<foreach:Order.Items>>). - Vytvářejte vnořené tabulky/seznamy se seskupováním + podmínkami.
Vlastní funkce a rozšiřitelnost
- Zaregistrujte rozšiřující metody nebo obslužné rutiny pro vlastní logiku.
- Provádějte specializované formátování a transformace.
Dědičnost šablon
- Definujte základní šablony a znovu je použijte v podřízených šablonách.
- Udržujte konzistentní branding a styly.
Události a callbacky
- Napojit se na
ReportBuildStarted,TagProcessed,ReportBuildFinished. - Přidejte protokolování, vkládejte grafy/obrázky nebo dynamicky upravujte výstup.
Lokalizace a internacionalizace
- Formátujte data, čísla a měny podle kultury.
- Integrujte soubory zdrojů pro vícejazyčné zprávy.
FAQ
- Jak se to liší od Mail Merge? LINQ Reporting používá textové značky a podporuje LINQ výrazy, na rozdíl od tradičních polí hromadné korespondence.
- Jaké zdroje dat jsou podporovány? XML, JSON, CSV, DataTables, Entity Framework a vlastní objekty .NET.
- Mohu vložit grafy a obrázky? Ano. Šablony mohou obsahovat grafy, čárové kódy a obrázky naplněné z dat.
- Jaké formáty mohu exportovat? DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML a Word 2007 XML.
- Podporuje to lokalizaci? Ano. Formátování s ohledem na kulturu a integrace zdrojů jsou podporovány.