Hier geht es darum die unterschiedlichen Einsatzgebiete des .NET DataTable Adapter anhand eines kleinen Beispiels zu erläutern. Die fertige Definition "DataTableAdapter_Common.fhd" können Sie sich im Verzeichnis Examples\DE\DataTablesAdapter ansehen. Zusätzlich dazu befindet sich im Verzeichnis VSCommon unterhalb des DataTableAdapter Verzeichnis eine Visual Studio Solution die alle Beispiele im .NET Source Code (C#) beinhaltet. Alle Beispiele sind im ZIP Archiv zum FlowHeater enthalten.

Hier gibt es keine Schritt für Schritt Anleitungen sondern anhand der fertigen Definition (siehe unten) wird erklärt wie Sie mit dem .NET DataTable Adapter umgehen müssen.

Eigene Adapter

Wenn Sie die Definition mit dem FlowHeater Designer öffnen dann sieht Ihr Bildschirm ungefähr so aus wie oben dargestellt. Sowohl auf der READ und auch auf der WRITE Seite befindet sich der DateTable Adapter. Führen Sie die Definition 1x im Testmodus und einmal so als ob Sie die Daten schreiben möchten aus. Siehe dazu die Hilfe zum Test und Ausführen Dialog.

Bitte beachten: Sie sehen das beim ersten ausführen keine Dialogbox angezeigt wird. Dies hat den Hintergrund, dass im Testmodus die .NET DLL der WRITE Seite nicht gerufen wird! Lediglich die .NET DLL der READ Seite wurde ausgeführt.

 

Woher kommen nun die Daten und wohin werden sie geschrieben?

Ganz einfach:

• Auf der READ Seite wird die Funktion public DataTable FlowHeater_GetDataTable(int rows) der Klasse FH_Read aus dem Assembly/DLL ReadSample.dll gerufen.
• Auf der WRITE Seite wird die Funktion public void FlowHeater_SetDataTable(DataTable dt) der Klasse FH_Write aus dem Assembly/DLL WriteSample.dll aufgerufen.

Die Namen der Assemblies/DLL´s sowie die Klassennamen sind willkürlich und können frei gewählt werden. Die Klasse die gerufen werden soll muss lediglich min. eine der beiden oben genannten Funktionen aufweisen. Die beiden DLL´s sind im Verzeichnis Examples\DE\DataTableAdapter\VSCommon\Bin enthalten.

Schauen Sie sich dazu auch die Visual Studio Solution an. Die Solution finden Sie im Verzeichnis Examples\DE\DataTableAdapter\VSCommon.

FlowHeater Engine im eigenen Programm nutzen

Um das gleiche Beispiel wie oben beschrieben im eigenen .NET Programm nutzen zu können, brauchen Sie lediglich einen Verweis auf die FlowHeater.Core.dll

Einsatzgebiete

• Sie benötigen einen Adapter der derzeit noch nicht vom FlowHeater unterstützt wird, dann haben Sie hiermit die Möglichkeit sich eigene Adapter (Light) zu entwickeln und in den FlowHeater zu integrieren.
• Sie müssen in Ihrem Programm ständig wechselnde Datenformate einlesen. Bisher mussten Sie dazu immer entweder das Programm anpassen und neu kompilieren oder aber das unbekannte Format vorher an das Format anpassen das Sie schon einlesen können.
• Sie wollen in Ihrem Programm unterschiedliche Exportformate / Pfade anbieten.
• und so weiter, ...