RdlcRptGenLite

RdlcRptGenLite – Automaattinen RDLC-raportti C#:ssa suoraan DataTablesta

Lataat ZIP-paketin, joka sisältää sekä lähdekoodin (RdlcRptGenLite.cs), demolomakkeen että tanskankielisen ohjeen. Luokkaa saa käyttää ja jakaa vapaasti MIT-lisenssillä.

RdlcRptGenLite on kehitetty ja kevennetty versio suositusta (mutta nyt kadonneesta) RdlcRptGen-projektista. Luokka on kirjoitettu C#:lla ja sen avulla voit luoda täysin toimivan RDLC-raportin suoraan DataTablesta – ilman Visual Studion raporttisuunnittelijaa. Raportin voi näyttää ReportViewer-komponentissa yhdellä koodirivillä.

RdlcRptGenLite poistaa esikonfiguroinnin tarpeen – luokka generoi RDLC XML -raporttimäärityksen automaattisesti DataTable-rakenteesi perusteella ja näyttää raportin suoraan.

Ominaisuudet ja käyttö

• Luo RDLC-raportit dynaamisesti: DataTablen sarakkeiden ja rivien perusteella.
• Helppo käyttöönotto: toimii yhdellä koodirivillä: new RdlcRptGenLite(myDataTable).DisplayReport();
• Näyttö ReportViewerin kautta: Tukee standardia ReportViewer-ohjainta Windows Forms -ympäristössä.
• Mukautettavat asetukset: Voit määrittää mm. raportin otsikon, fontin, taulukon värit ja sivuasetukset.

Käyttöesimerkki

RdlcRptGenLite report = new RdlcRptGenLite(myDataTable);
report.ReportTitle = "Myyntiluvut Q2";
report.FontName = "Segoe UI";
report.DisplayReport(); // Näyttää raportin vakiomuotoisessa ReportViewer-ikkunassa

Hyödyt kehittäjille

RdlcRptGenLite sopii kehittäjille, jotka työskentelevät liiketoimintadatan, taustajärjestelmäraporttien, tilastojen tai hallinnollisten järjestelmien parissa, kun dynaamiset raportit pitää tuottaa nopeasti ja vaivattomasti – ilman raskasta integraatiota tai ulkoista raporttisuunnittelijaa.

Lataat ZIP-paketin, joka sisältää sekä lähdekoodin (RdlcRptGenLite.cs), demolomakkeen että tanskankielisen ohjeen. Luokkaa saa käyttää ja jakaa vapaasti MIT-lisenssillä.

---

Top 5 vinkkiä RdlcRptGenLitelle

Aloita yksinkertaisella DataTablella

RdlcRptGenLite toimii parhaiten yksinkertaisella ja litteällä rakenteella. Vältä monimutkaisia tyyppejä, kuten sisäkkäisiä objekteja, DataRelation-riippuvuuksia tai erikoisluokkia. Suosi sen sijaan tavallisia sarakkeita, joiden tyypit ovat string, int, decimal, DateTime jne. Tämä varmistaa virheettömän RDLC XML -generoinnin ja siistin taulukkomuodon näkymässä.

Vinkki: Voit tarvittaessa muokata sarakeotsikoita ominaisuudella DataTable.Columns[i].ColumnName, jotta raportin otsikot ovat selkeämmät.

Mukauta raportin ulkoasua

RdlcRptGenLite tukee useita hyödyllisiä ominaisuuksia, joilla voit muokata raportin ulkoasua ilman, että käsittelet RDLC-tiedostoa manuaalisesti:

• ReportTitle: Lisää otsikon raportin yläreunaan.
• FontName: Vaihda esimerkiksi Segoe UI-, Verdana- tai haluamaasi fonttiin.
• TableHeaderBackColor: Muuta sarakeotsikoiden taustaväriä.
• PageOrientation: Valitse pysty- tai vaaka-asettelu.

Vinkki: Yhdistä useita ominaisuuksia, jotta ne vastaavat yrityksesi visuaalista identiteettiä.

Käytä ReportVieweria Windows Forms -ympäristössä

Jotta raportti näkyy oikein, Microsoft.ReportViewer.WinForms tulee asentaa NuGetin kautta tai referenssinä. RdlcRptGenLite avaa uuden Form-ikkunan ReportViewerilla ja näyttää raportin automaattisesti – et tarvitse lisäistä käyttöliittymäkoodia.

Vinkki: Jos käytät .NET Framework 4.7:ää tai uudempaa, varmista, että käytössäsi on yhteensopiva ReportViewer-versio.

Tallenna raportti XML:nä

Haluatko tallentaa dynaamisesti luodun raportin RDLC-tiedostona myöhempää käyttöä tai muokkausta varten? Käytä:

string rdlcXml = report.GetRdlcXml();File.WriteAllText("MinRapport.rdlc", rdlcXml);

Tämä on tehokas tapa muuntaa ajonaikaiset raportit pysyviksi design-tiedostoiksi.

Vinkki: Voit avata tallennetun .rdlc-tiedoston Visual Studiossa ja hienosäätää asettelua graafisesti tarvittaessa.

Yhdistä DataSeteihin edistyneitä ominaisuuksia varten

Vaikka RdlcRptGenLite käyttää DataTablea ensisijaisena syötteenä, voit hyvin poimia tauluja DataSetistä ja välittää ne eteenpäin:

new RdlcRptGenLite(myDataSet.Tables["OrdreData"]).DisplayReport();

Tämä mahdollistaa työskentelyn useiden tietolähteiden kanssa ja silti yksinkertaisen rajapinnan käytön.

Vinkki: Voit tehdä wrapper-menetelmän, joka valitsee automaattisesti sopivat taulukot käyttäjän syötteen tai liiketoimintalogiikan perusteella.