Aspose.Words Silnik raportowania LINQ dla .NET
Aspose.Words LINQ Reporting Engine for .NET umożliwia twórcom tworzenie bogatszych, opartych na danych raportów poprzez połączenie syntazy etykiet płaskich tekstów z zapytaniami dotyczącymi linku. raporty mogą być powiązane z kolekcjami, bazami danych, JSON, XML lub indywidualnymi obiektami, z filtrowaniem, grupowaniem i agregacją wykonywanymi bezpośrednio wewnątrz szablonu.
Instalacja i ustawienie
- Instalacja pakietu NuGet
Aspose.Words. - Użytkownik otrzymuje licencję ( Licencjonowanie według zużycia ).
- Dodaj referencję do
Aspose.WordsUpewnij się, że uzależnienia są włączone. - Dla pełnych kroków, zobacz Instalacja przewodnik .
**Przekierowane platformy: ** Windows, Linux, macOS i mobilny system operacyjny z .NET Framework, .Net Core, ,NET 5/6+, lub Mono.IDES: Visual Studio 2010–2022, Xamarin, MonoDevelop.
Szybki start: Tworzenie raportu z 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");Charakterystyka i funkcjonalność
Sztuka syntax
- Tagi jak
<<Name>>,<<foreach:Orders>>,<<if:Condition>>Są ludzko czytelne. - Wspierane w ustępach, tabelach, nagłówkach i stopach.
Link danych wiążący
- Połączyć do kolekcji, tabeli danych, EF zapytania, JSON, XML lub obiektów dostosowanych.
- Wpisy z linku:
Where,OrderBy,GroupBy, i projekcji.
Filtrowanie, grupowanie i sortowanie
- Bloki warunkowe z
<<if:…>>/<<endif>>. - Dane grupowe z
<<groupby:Property>>. - Inline zamówienie z
orderbyz klauzulą.
Funkcje agregacji
- Wbudowane w tagi:
<<sum:>>,<<avg:>>,<<count>>,<<min:>>,<<max:>>. - Automatyczne aktualizacje podczas zmiany zestawów danych.
Warunkowy i logiczny switch
- Używanie
<<switch:Expression>>,<<case:Value>>,<<default>>dla wielu scenariuszy. - Uproszczaj szablony z różnymi layoutami.
Dane Nested & Hierarchiczne
- nawigacja w grafikach obiektów (np.,
<<foreach:Order.Items>>). - Budować tabele / listy z grupowaniem + warunków.
Dostosowane funkcje i rozszerzenie
- Zarejestruj metody rozszerzenia lub handlowców dla przyzwoitej logiki.
- Wykonaj specjalistyczne formatowanie i transformacje.
Dziedzictwo Template
- Określ podstawowe szablony i ponownie je używaj w szablonach dla dzieci.
- Utrzymuj konsekwentny branding i stylizację.
Wydarzenia & Callbacks
- Wejdź do
ReportBuildStarted,TagProcessed,ReportBuildFinished. - Dodaj logowanie, wstrzyknij wykresy / obrazy lub dynamicznie zmodyfikuj wyjście.
Lokalizacja i międzynarodowość
- Format daty, liczby, waluty według kultury.
- Integracja plików zasobów dla raportów wielojęzycznych.
FAQ
**Jak to różni się od Mail Merge?**LINQ Reporting wykorzystuje etykiety tekstowe i obsługuje wyrażenia linku, w przeciwieństwie do tradycyjnych pól połączenia poczty.
**Jakie źródła danych są obsługiwane?**XML, JSON, CSV, DataTables, Entity Framework i dostosowane obiekty .NET.
**Czy mogę wstawić wykresy i obrazy?**Tak. szablony mogą zawierać wykresy, kody rzęs i obrazy zebrane z danych.
**Jakie formaty mogę wyprodukować?**DOCX, PDF, HTML, RTF, ODT i wszystkie formaty obsługiwane przez Aspose.Words.
**Czy jest to wsparcie lokalizacji?**Wspierane są formatyzacja kulturowa i integracja zasobów.