|
|
|
|
|
Eine Eurokonvertierungskomponente in C# erstellen
Geschrieben von: Christoph Wille Die Einführung des "angreifbaren" Eurogeldes rückt immer näher, und die doppelte Preisauszeichnung ist mittlerweile auch schon überall zu sehen. Letztes Jahr haben wir uns im Artikel Preisauszeichnung in Euro mit ASP bereits mit diesem Thema beschäftigt, allerdings haben wir damals eine bereits bestehende Komponente von AlphaSierraPapa verwendet. Heute werden wir diese Komponente mit C# nachprogrammieren - und zwar weil eine native .NET Komponente viel performanter ist als wenn man die existierende COM Komponente mit Interop in ASP.NET einbindet (siehe dazu auch der Artikel Verwenden von COM Komponenten in ASP.NET). Die FunktionalitätFolgende öffentlich angreifbare Funktionen werden wir in die Komponente einbauen:
public double GetExchangeRate(String strCurrencySymbol);
public double ConvertToEuro(double dVal2Convert, string strCurrencyFrom);
public double ConvertFromEuro(double dVal2Convert, string strCurrencyTo);
public double Triangulate(double dVal2Convert, string strCurrencyFrom,
string strCurrencyTo);
Diese Funktionen entsprechen dem, was die COM Komponente auch "leistet". Intern gibt es dann noch die Round Methode, die die korrekte Rundung nach den Richtlinien der EMU (European Monetary Union) durchführt. Zum Programmieren der Komponente kann man aus einer Vielzahl von Tools wählen, so zum Beispiel Notepad, Visual Studio.NET uvm. Ich habe mich für den Open Source Editor SharpDevelop entschieden (siehe Screenshot). 
Die UmrechnungsfaktorenDie Umrechnungskurse für die Länder, die an der Währungsunion teilnehmen, finden sich bei der Euro Info der EU. Mit diesen Kursen ausgestattet, kann man beginnen, die Komponente zu programmieren. Ich habe mich entschieden, die Zuordnung der Währungskurse zu den Währungssymbolen in einem Hashtable zu implementieren (geschützte Membervariable, Initialisierung im Konstruktor):
protected Hashtable m_MapCurrencySymbol2Factor;
public EuroConverter()
{
m_MapCurrencySymbol2Factor = new Hashtable();
m_MapCurrencySymbol2Factor.Add("ATS", 13.7603); // Austria
m_MapCurrencySymbol2Factor.Add("BEF", 40.3399); // Belgium
m_MapCurrencySymbol2Factor.Add("LUF", 40.3399); // Luxemburg
m_MapCurrencySymbol2Factor.Add("FIM", 5.94573); // Finland
m_MapCurrencySymbol2Factor.Add("FRF", 6.55957); // France
m_MapCurrencySymbol2Factor.Add("DEM", 1.95583); // Germany
m_MapCurrencySymbol2Factor.Add("IEP", 0.787564); // Ireland
m_MapCurrencySymbol2Factor.Add("ITL", 1936.27); // Italy
m_MapCurrencySymbol2Factor.Add("NLG", 2.20371); // Netherlands
m_MapCurrencySymbol2Factor.Add("PTE", 200.482); // Portugal
m_MapCurrencySymbol2Factor.Add("ESP", 166.386); // Spain
m_MapCurrencySymbol2Factor.Add("GRD", 340.750); // Greece
}
Konvertieren von Landeswährung nach EuroDer Funktion ConvertToEuro wird eine Dezimalzahl und ein Währungssymbol übergeben. Anhand des Währungssymbols wird der Umrechnungskurs aus dem Hashtable ausgelesen, und dann die Konvertierung durchgeführt:
public double ConvertToEuro(double dVal2Convert, string strCurrencyFrom)
{
if (!m_MapCurrencySymbol2Factor.ContainsKey(strCurrencyFrom))
{
throw new ArgumentException("Lookup of currency symbol failed!");
}
double dRate = (double)m_MapCurrencySymbol2Factor[strCurrencyFrom];
return Round((dVal2Convert / dRate));
}
Sollte das Währungssymbol nicht in unserem Hashtable gespeichert sein, so lassen wir dies dem Benutzer der Komponente mit einer ArgumentException wissen. Der Rest der Rechnung ist einfach, bis auf die Verwendung der selbstgebastelten Round Funktion - es gibt nämlich eigene Rundungsregeln für das Rechnen mit Euro! Hier ist ein korrekte Implementierung nach den Richtlinien der EMU:
protected double Round(double dVal2Round)
{
// first, strip off everything after third decimal
double dVal2 = 0.0;
dVal2Round *= 1000;
dVal2 = Fix(dVal2Round);
// now, round the result
dVal2 /= 10;
dVal2Round = Fix(dVal2 + (dVal2 > 0 ? 0.5 : -0.5));
// we are done.
return (dVal2Round/100);
}
Die Round Methode verwendet eine Funktion namens Fix, die ebenso nicht Bestandteil von C# oder dem .NET Framework ist - sie liefert genauso wie das VB Pendant den Ganzzahlteil der Double Variable:
protected double Fix(double dVarIn)
{
if (Math.Sign(dVarIn) < 0)
{
// less than 0, negative values
return Math.Ceiling(dVarIn);
}
else
{
return Math.Floor(dVarIn);
}
return -1; // unreachable code; intentionally
}
Damit hätten wir die Methode ConvertToEuro besprochen - ConvertFromEuro ist analog implementiert. TriangulierenUnter Triangulation versteht man den Vorgang des Konvertieren eines Geldbetrages von einer Eurowährung in eine andere, zum Beispiel Schilling in Deutsche Mark. Dabei rechnet man erst den Betrag in Schilling nach Euro, und dann von Euro nach Deutsche Mark. Eine direkte Umrechnung ist nicht gestattet. Der entsprechende Sourcecode sieht wie folgt aus:
public double Triangulate(double dVal2Convert, string strCurrencyFrom,
string strCurrencyTo)
{
if (!m_MapCurrencySymbol2Factor.ContainsKey(strCurrencyFrom) ||
!m_MapCurrencySymbol2Factor.ContainsKey(strCurrencyTo))
{
throw new ArgumentException("Lookup of currency symbol failed!");
}
double dRateFrom =(double)m_MapCurrencySymbol2Factor[strCurrencyFrom];
double dRateTo = (double)m_MapCurrencySymbol2Factor[strCurrencyTo];
// do the conversion
double dHelper = dVal2Convert / dRateFrom;
dHelper *= dRateTo;
return Round(dHelper);
}
Damit hätten wir alle wichtigen Funktionen der Komponente durchbesprochen - klicken Sie hier, um den gesamten Sourcecode der Komponente zu betrachten. Die Komponente verwendenNatürlich muß man die Komponente zuallererst kompilieren - entweder mit Hilfe des Editors, oder über die Kommandozeile: csc /out:EuroConv.dll /target:library EuroConv.cs Wenn man die Komponente in ASP.NET einsetzt, kopiert man sie am besten in das bin Verzeichnis der Web Site - damit steht sie automatisch allen Seiten zur Verfügung, so zum Beispiel meiner Testseite simple.aspx:
<% @Page Language= "C#" %>
<% @Import Namespace="AlphaSierraPapa.Utilities" %>
<%
EuroConverter ecuConv = new EuroConverter();
Response.Write(ecuConv.ConvertToEuro(100, "ATS") + "<br>");
Response.Write(ecuConv.ConvertFromEuro(100, "ATS") + "<br>");
Response.Write(ecuConv.Triangulate(100, "ATS", "DEM") + "<br>");
Response.Write(ecuConv.GetExchangeRate("ESP") + "<br>");
%>
Das ist natürlich nur eine äußerst einfach gehaltene Testseite, die alle zur Verfügung gestellten Methoden einmal einbindet. Im täglichen Betrieb wird die Komponente aber gute Dienste leisten. SchlußbemerkungDie heute vorgestellte Komponente stellt alle Funktionen bereit, die man zur korrekten Konvertierung von Geldbeträgen der Euroteilnehmerstaaten benötigt - und zwar als native .NET Komponente. Diese kann sowohl in ASP.NET als auch WinForms oder Kommandozeilenapplikationen eingesetzt werden. Download des CodesKlicken Sie hier, um den Download zu starten. Verwandte Artikel
Eine Klasse für sich - die .NET Zip Library Links zu anderen Sites
Euro Conversion Component Wenn Sie jetzt Fragen haben...Wenn Sie Fragen rund um die in diesem Artikel vorgestellte Technologie haben, dann schauen Sie einfach bei uns in den Community Foren der deutschen .NET Community vorbei. Die Teilnehmer helfen Ihnen gerne, wenn Sie sich zur im Artikel vorgestellten Technologie weiterbilden möchten.
Eine weitere sehr hilfreiche Resource ist das deutsche ASP.NET Wiki, das als zentrale Anlaufstelle für Tips, Tricks, Know How und alles Nützliche was man in seinem Alltag als (ASP).NET-Entwickler so braucht und entdeckt gedacht ist. Haben Sie Fragen die sich direkt auf den Inhalt des Artikels beziehen, dann schreiben Sie dem Autor! Unsere Autoren freuen sich über Feedback zu ihren Artikeln. Ein einfacher Klick auf die Autor kontaktieren Schaltfläche (weiter unten) und schon haben Sie ein für diesen Artikel personalisiertes Anfrageformular.
Und zu guter Letzt möchten wir Sie bitten, den Artikel zu bewerten. Damit helfen Sie uns, die Qualität der Artikel zu verbessern - und anderen Lesern bei der Auswahl der Artikel, die sie lesen sollten.
©2000-2006 AspHeute.com |
