DLL-Methoden hinzufügen (.NET 2 FORTRAN) - Revision history

Froehlich: fix syntax highlighting

2018-01-27T16:43:53Z

fix syntax highlighting

← Older revision		Revision as of 09:43, 27 January 2018
Line 3:		Line 3:

	== Hinzufügen der neuen Methode in der BlueM.Sim Fortran-DLL ==		== Hinzufügen der neuen Methode in der BlueM.Sim Fortran-DLL ==
	<fortran>		<source lang="fortran">
	logical function GetModelDescription(Description)		logical function GetModelDescription(Description)
	!DEC$ ATTRIBUTES DLLEXPORT :: GETMODELDESCRIPTION		!DEC$ ATTRIBUTES DLLEXPORT :: GETMODELDESCRIPTION
Line 9:		Line 9:
	...		...
	end function		end function
	</~~fortran~~>		</source>
	* Funktionsname und DLLEXPORT-Name müssen gleich sein !		* Funktionsname und DLLEXPORT-Name müssen gleich sein !
	* Übergabeparameter müssen definiert sein (und die Typen sollten so einfach wie möglich sein) !		* Übergabeparameter müssen definiert sein (und die Typen sollten so einfach wie möglich sein) !
Line 24:		Line 24:


	<csharp>		<source lang="csharp">
	public class DLLMethoden		public class DLLMethoden
	{		{
Line 40:		Line 40:
	...		...
	}		}
	</~~csharp~~>		</source>

	==== Delegate ====		==== Delegate ====
Line 47:		Line 47:
	==== Marshaling ====		==== Marshaling ====
	* Um Typensicherheit zu gewährleiseten, gibt es in .NET die Attributsklasse <code>MarshalAs</code>. Über diese Klasse können Typen aus unmanaged Code und dem .NET Code ausgetauscht werden - z.B. <code>r8</code> und <code>double</code> oder wie bei <code>GetModelDescriptionDelegate</code> eine Zeichenkette (<code>LPStr</code>/<code>StringBuilder</code>):		* Um Typensicherheit zu gewährleiseten, gibt es in .NET die Attributsklasse <code>MarshalAs</code>. Über diese Klasse können Typen aus unmanaged Code und dem .NET Code ausgetauscht werden - z.B. <code>r8</code> und <code>double</code> oder wie bei <code>GetModelDescriptionDelegate</code> eine Zeichenkette (<code>LPStr</code>/<code>StringBuilder</code>):
	<csharp> [MarshalAs(UnmanagedType.LPStr)] StringBuilder description </~~csharp~~>		<source lang="csharp"> [MarshalAs(UnmanagedType.LPStr)] StringBuilder description </source>
	* Um eine Zeichenkette mit der Fortran-DLL auszutauschen, muss zu dem inhalt immer auch die Länge des Strings angegeben werden:		* Um eine Zeichenkette mit der Fortran-DLL auszutauschen, muss zu dem inhalt immer auch die Länge des Strings angegeben werden:
	<csharp> uint length </~~csharp~~>		<source lang="csharp"> uint length </source>

	==== Aufruf der DLL-Methode ====		==== Aufruf der DLL-Methode ====
	<csharp>IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");</~~csharp~~>		<source lang="csharp">IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");</source>
	Holt sich die Einsprungadresse der DLL_Methode.		Holt sich die Einsprungadresse der DLL_Methode.
	<csharp>GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));</~~csharp~~>		<source lang="csharp">GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));</source>
	Die Einsprungadresse und der "Platzhalter" werden miteinander verknüpft. Nun kann man einfach die Delegatmethode mit den entsprechenden Parametern aufrufen:		Die Einsprungadresse und der "Platzhalter" werden miteinander verknüpft. Nun kann man einfach die Delegatmethode mit den entsprechenden Parametern aufrufen:
	<csharp>cpv(description, (uint)description.Length);</~~csharp~~>		<source lang="csharp">cpv(description, (uint)description.Length);</source>

	[[Category:Fortran]]		[[Category:Fortran]]

Froehlich: moved DLL-Methoden hinzufÃ¼gen (.NET 2 FORTRAN) to DLL-Methoden hinzufügen (.NET 2 FORTRAN)

2009-10-26T16:29:11Z

moved DLL-Methoden hinzufÃ¼gen (.NET 2 FORTRAN) to DLL-Methoden hinzufügen (.NET 2 FORTRAN)

← Older revision	Revision as of 09:29, 26 October 2009
(No difference)

Froehlich at 08:19, 9 September 2009

2009-09-09T08:19:52Z

← Older revision		Revision as of 01:19, 9 September 2009
Line 58:		Line 58:
	<csharp>cpv(description, (uint)description.Length);</csharp>		<csharp>cpv(description, (uint)description.Length);</csharp>

	[[~~Kategorie~~:Fortran]]		[[Category:Fortran]]
	[[~~Kategorie~~:OpenMI]]		[[Category:OpenMI]]
	[[~~Kategorie~~:Hilfe]]		[[Category:Hilfe]]
	[[~~Kategorie~~:BlueM.Sim Development]]		[[Category:BlueM.Sim Development]]
			[[Category:.NET]]

Froehlich: hat „DLL-Methoden hinzufÃ¼gen (.NET 2 FORTRAN)“ nach „DLL-Methoden hinzufügen (.NET 2 FORTRAN)“ verschoben

2009-03-27T21:36:29Z

hat „DLL-Methoden hinzufÃ¼gen (.NET 2 FORTRAN)“ nach „DLL-Methoden hinzufügen (.NET 2 FORTRAN)“ verschoben

← Older revision	Revision as of 14:36, 27 March 2009
(No difference)

Froehlich at 12:13, 24 March 2009

2009-03-24T12:13:11Z

← Older revision		Revision as of 05:13, 24 March 2009
Line 1:		Line 1:
	<div style="float:~~left~~; margin-~~right~~:10px">__TOC__</div>		<div style="float:right; margin-left:10px">__TOC__</div>
	~~<big>~~ Anleitung für das Hinzufügen neuer Methoden in eine Modell-DLL (am Beispiel von [[BlueM]]) ~~</big>~~<br clear="all"/>		Anleitung für das Hinzufügen neuer Methoden in eine Modell-DLL (am Beispiel von [[BlueM.Sim]])<br clear="all">

	~~== Hinzufügen der neuen Methode in der BlueM Fortran-DLL ==~~

			== Hinzufügen der neuen Methode in der BlueM.Sim Fortran-DLL ==
	<fortran>		<fortran>
	logical function GetModelDescription(Description)		logical function GetModelDescription(Description)
Line 16:		Line 15:

	; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.		; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.


	~~[[Kategorie:Fortran]]~~

	== Erweiterung des [[BlueM.DLLAdapter\|DLL-Wrappers]] (C#) ==		== Erweiterung des [[BlueM.DLLAdapter\|DLL-Wrappers]] (C#) ==
Line 62:		Line 58:
	<csharp>cpv(description, (uint)description.Length);</csharp>		<csharp>cpv(description, (uint)description.Length);</csharp>

			[[Kategorie:Fortran]]
	[[Kategorie:OpenMI]]		[[Kategorie:OpenMI]]
	[[Kategorie:Hilfe]]		[[Kategorie:Hilfe]]
	[[Kategorie:BlueM.Sim Development]]		[[Kategorie:BlueM.Sim Development]]

Froehlich at 12:06, 24 March 2009

2009-03-24T12:06:06Z

← Older revision		Revision as of 05:06, 24 March 2009
Line 65:		Line 65:
	[[Kategorie:OpenMI]]		[[Kategorie:OpenMI]]
	[[Kategorie:Hilfe]]		[[Kategorie:Hilfe]]
	[[Kategorie:BlueM ~~Code]]~~		[[Kategorie:BlueM.Sim Development]]
	~~[[Kategorie:BlueM Entwicklung~~]]

Froehlich: /* Erweiterung des DLL-Wrappers (C#) */

2008-08-15T11:03:28Z

Erweiterung des DLL-Wrappers (C#)

← Older revision		Revision as of 04:03, 15 August 2008
Line 25:		Line 25:
	# Hinzufügen des Delegats in DLLMethoden		# Hinzufügen des Delegats in DLLMethoden
	# Hinzufügen der Schnittstellenmethode		# Hinzufügen der Schnittstellenmethode
	# Hinzufügen einer Testmethode [[UnitTest]]		# Hinzufügen einer Testmethode (siehe [[intern:UnitTest\|UnitTest]])

Reussner: /* Hinzufügen der neuen Methode in der BlueM Fortran-DLL */

2008-06-24T09:42:15Z

Hinzufügen der neuen Methode in der BlueM Fortran-DLL

← Older revision		Revision as of 02:42, 24 June 2008
Line 17:		Line 17:
	; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.		; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.


			[[Kategorie:Fortran]]

	== Erweiterung des [[BlueM.DLLAdapter\|DLL-Wrappers]] (C#) ==		== Erweiterung des [[BlueM.DLLAdapter\|DLL-Wrappers]] (C#) ==

Reussner: Umgestaltung der Hilfeseiten

2008-05-20T12:30:12Z

Umgestaltung der Hilfeseiten

New page

<div style="float:left; margin-right:10px">__TOC__</div>
<big> Anleitung für das Hinzufügen neuer Methoden in eine Modell-DLL (am Beispiel von [[BlueM]]) </big><br clear="all"/>

== Hinzufügen der neuen Methode in der BlueM Fortran-DLL ==

<fortran>
logical function GetModelDescription(Description)
!DEC$ ATTRIBUTES DLLEXPORT :: GETMODELDESCRIPTION
character(*) Description
...
end function
</fortran>
* Funktionsname und DLLEXPORT-Name müssen gleich sein !
* Übergabeparameter müssen definiert sein (und die Typen sollten so einfach wie möglich sein) !

; Tip : Kontrollieren, ob der Export funktioniert hat, kann man mit dem DependencyWalker des Visual Studios <br/><code>C:\Programme\Microsoft Visual Studio 8\Common7\Tools\Bin\Depends.Exe</code>. <br/>Dort werden alle exportierte Methoden aufgelistet.

== Erweiterung des [[BlueM.DLLAdapter|DLL-Wrappers]] (C#) ==
Die Methoden der DLL werden aus der Klasse <code>DLLMethoden</code> aufgerufen.

# Hinzufügen des Delegats in DLLMethoden
# Hinzufügen der Schnittstellenmethode
# Hinzufügen einer Testmethode [[UnitTest]]

<csharp>
public class DLLMethoden
{
...
delegate bool GetModelDescriptionDelegate([MarshalAs(UnmanagedType.LPStr)] StringBuilder description, uint length);
...
public bool GetModelDescription(StringBuilder description, uint length)
{
if (myDll == IntPtr.Zero)
InitializeMyDll(pathToDll);
IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");
GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));
return cpv(description, (uint)description.Length);
}
...
}
</csharp>

==== Delegate ====
Eine Delegatmethode ist eine Art "Platzhalter". in diesem Beispiel fungiert sie als Platzhalter für die Fortran-DLL. Sie hat die selben Übergabeparameter wie in der Fortran-DLL beschrieben - Ausnahme sind Zeichenketten (Siehe [[#Marshaling|Marshaling]]).

==== Marshaling ====
* Um Typensicherheit zu gewährleiseten, gibt es in .NET die Attributsklasse <code>MarshalAs</code>. Über diese Klasse können Typen aus unmanaged Code und dem .NET Code ausgetauscht werden - z.B. <code>r8</code> und <code>double</code> oder wie bei <code>GetModelDescriptionDelegate</code> eine Zeichenkette (<code>LPStr</code>/<code>StringBuilder</code>):
<csharp> [MarshalAs(UnmanagedType.LPStr)] StringBuilder description </csharp>
* Um eine Zeichenkette mit der Fortran-DLL auszutauschen, muss zu dem inhalt immer auch die Länge des Strings angegeben werden:
<csharp> uint length </csharp>

==== Aufruf der DLL-Methode ====
<csharp>IntPtr pProc = DllImportDynamic.GetProcAddress(myDll, "OPENMI_mp_GETMODELDESCRIPTION");</csharp>
Holt sich die Einsprungadresse der DLL_Methode.
<csharp>GetModelDescriptionDelegate cpv = (GetModelDescriptionDelegate)Marshal.GetDelegateForFunctionPointer(pProc, typeof(GetModelDescriptionDelegate));</csharp>
Die Einsprungadresse und der "Platzhalter" werden miteinander verknüpft. Nun kann man einfach die Delegatmethode mit den entsprechenden Parametern aufrufen:
<csharp>cpv(description, (uint)description.Length);</csharp>

[[Kategorie:OpenMI]]
[[Kategorie:Hilfe]]
[[Kategorie:BlueM Code]]
[[Kategorie:BlueM Entwicklung]]