.NET-Schnittstelle
Die .NET-Schnittstelle ist als Wrapper rund um die RaptorXML COM-Schnittstelle gebaut. Sie dient als primäre von Altova signierte Interop-Assembly und verwendet den Namespace Altova.RaptorXMLServer.
Hinzufügen der RaptorXML DLL als Referenz zum Visual Studio .NET-Projekt
Um RaptorXML in Ihrem .NET-Projekt verwenden zu können, fügen Sie in Ihrem Projekt eine Referenz zur RaptorXML-DLL (Altova.RaptorXMLServer.dll) hinzu. Ihre RaptorXML Server Installation enthält eine signierte DLL-Datei namens Altova.RaptorXMLServer.dll, die bei der Installation von RaptorXML mit Hilfe des RaptorXML Installationsprogramms automatisch zum globalen Assembly Cache (GAC) hinzugefügt wird. Normalerweise befindet sich der GAC im Ordner C:\WINDOWS\assembly.
Um die RaptorXML-DLL als Referenz in einem .NET-Projekt hinzuzufügen, gehen Sie folgendermaßen vor:
| 1. | Klicken Sie bei geöffnetem .NET-Projekt auf Project | Add Reference. Daraufhin wird das Dialogfeld "Add Reference" (Abbildung unten) angezeigt |
1.Navigieren Sie auf dem Register "Browse" zum Ordner: <RaptorXML application folder>/bin, wählen Sie die RaptorXML DLL Altova.RaptorXMLServer.dll aus und klicken Sie auf OK.
2.Wählen Sie den Befehl View | Object Browser, um die Objekte der RaptorXML API zu sehen.
Sobald die Altova.RaptorXMLServer.dll der .NET-Schnittstelle zur Verfügung steht und RaptorXML als COM-Serverobjekt registriert wurde, stehen die RaptorXML-Funktionalitäten in Ihrem .NET-Projekt zur Verfügung.
| Anmerkung: | RaptorXML wird bei der Installation automatisch als COM-Serverobjekt registriert, daher ist eine manuelle Registrierung nicht erforderlich. |
| Anmerkung: | Falls Sie einen Zugriffsfehler erhalten, vergewissern Sie sich, dass die Berechtigungen richtig eingestellt sind. Gehen Sie zu "Component Services" und geben Sie demselben Benutzerkonto, über das der Application Pool, der RaptorXML enthält, ausgeführt wird, Zugriffsberechtigungen. |
Codebeispiele
In den folgenden Kapiteln finden Sie ein C#-Beispiel und ein Visual Basic .NET-Beispiel zur Verwendung der RaptorXML API über ihre .NET-Schnittstelle. Die Dateien zu diesen Beispielen befinden sich im RaptorXML-Applikationsordner im Ordner examples/serverAPI.