Bevor Sie unter Verwendung von QAnywhere .NET-Clients Nachrichten versenden oder empfangen können, müssen Sie die folgenden Initialisierungsaufgaben durchführen.

Sie müssen zwei Änderungen in Ihrem Visual Studio-Projekt vornehmen, um es verwenden zu können:

Außerdem müssen Sie die QAnywhere .NET-API initialisieren.

♦  So fügen Sie einen Verweis auf die QAnywhere .NET-API in ein Visual Studio-Projekt ein

1. Starten Sie Visual Studio und öffnen Sie Ihr Projekt.

2. Klicken Sie im Projektmappen-Explorer-Fenster mit der rechten Maustaste auf den Ordner Referenzen und wählen Sie Referenz hinzufügen.

3. Im Register .NET klicken Sie auf Durchsuchen, um den Speicherort von iAnywhere.QAnywhere.Client.dll zu ermitteln. Die Standardspeicherorte sind:

   • .NET Framework 2.0: Installationsverzeichnis\Assembly\v2
   • .NET Compact Framework 2.0: Installationsverzeichnis\ce\Assembly\v2

   Wählen Sie die DLL und klicken Sie auf Öffnen

4. Sie können überprüfen, ob die DLL Ihrem Projekt hinzugefügt wurde. Öffnen Sie das Fenster Verweis hinzufügen und klicken Sie auf das Register .NET. iAnywhere.Data.SQLAnywhere.dll erscheint in der Liste Ausgewählte Komponenten. Klicken Sie auf OK, um das Fenster zu schließen.

In Ihrem Quellcode auf die Datenproviderklassen verweisen

♦  So verweisen Sie auf die QAnywhere .NET API-Klassen in Ihrem Quellcode

1. Starten Sie Visual Studio und öffnen Sie Ihr Projekt.

2. Wenn Sie C# verwenden, fügen Sie in die Liste der using-Direktiven am Dateibeginn folgende Zeile ein:

   using iAnywhere.QAnywhere.Client;

3. Wenn Sie Visual Basic verwenden, fügen Sie in die Liste der Importe am Beginn Ihrer Datei folgende Zeilen ein:

   Imports iAnywhere.QAnywhere.Client

   Die Zeile ist nicht unbedingt erforderlich. Allerdings sorgt sie dafür, dass Sie für die QAnywhere-Klassen Kurzformen verwenden können. Wenn diese Zeile nicht vorhanden ist, können Sie den voll qualifizierten Klassennamen in Ihrem Programmcode verwenden. Zum Beispiel:

   iAnywhere.QAnywhere.Client.QAManager mgr = new iAnywhere.QAnywhere.Client.QAManagerFactory.Instance.CreateQAManager( "qa_manager.props" );

   Mit ihr schreiben Sie wie folgt:

   QAManager mgr = QAManagerFactory.Instance.CreateQAManager( "qa_manager.props" );

♦  So initialisieren Sie die QAnywhere .NET-API

1. Integrieren Sie den iAnywhere.QAnywhere.Client-Namespace, wie in der vorherigen Prozedur beschrieben.

   using iAnywhere.QAnywhere.Client;

2. Erstellen Sie ein QAManager-Objekt.

   Beispiel: Um ein Standard-QAManager-Objekt zu erstellen, rufen Sie CreateQAManager mit "null" als Parameter auf:

   QAManager mgr; mgr = QAManagerFactory.Instance.CreateQAManager( null );

   Tipp

   Um hohe Parallelität zu gewährleisten, sollten Multi-Thread-Anwendungen ein QAManager-Objekt für jeden Thread erstellen. Weitere Hinweise finden Sie unter Hinweise zu Multi-Threading.

   Weitere Informationen zu QAManagerFactory finden Sie unter QAManagerFactory-Klasse.

   Als Alternative können Sie ein QAManager-Objekt erstellen, das unter Verwendung einer Eigenschaftsdatei angepasst wird. Die Eigenschaftsdatei wird in der CreateQAManager-Methode angegeben:

   mgr = QAManagerFactory.Instance.CreateQAManager( "qa_mgr.props" );

   Dabei gilt: qa_mgr.props ist der Name der Eigenschaftsdatei auf dem entfernten Gerät.

3. Initialisieren Sie das QAManager-Objekt. Zum Beispiel:

   mgr.Open( AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);

   Das Argument für die open-Methode ist ein Bestätigungsmodus, der festlegt, wie die Nachrichten bestätigt werden sollen. Das Argument muss IMPLICIT_ACKNOWLEDGEMENT oder EXPLICIT_ACKNOWLEDGEMENT sein. Bei impliziter Bestätigung werden Meldungen bestätigt, wenn sie vom Client empfangen werden. Bei expliziter Bestätigung müssen Sie eine der Acknowledge-Methoden im QAManager aufrufen, um die Nachricht zu bestätigen.

   Weitere Informationen zu Bestätigungsmodi finden Sie unter AcknowledgementMode-Enumeration.

Sie sind nun bereit, Nachrichten zu versenden.

Siehe auch

• QAnywhere .NET-API für Clients (.NET 2.0)