Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » QAnywhere » 编写 QAnywhere 客户端应用程序 » 初始化 QAnywhere API

 

设置 .NET 应用程序

使用 QAnywhere .NET 客户端发送或接收消息之前,必须完成以下初始化任务。

Visual Studio 项目必须进行两项更改后才能使用:

  • 添加对 QAnywhere .NET DLL 的引用。添加引用可通知 Visual Studio .NET 包含哪个 DLL,以找到 QAnywhere .NET API 的代码。

  • 在源代码中添加一行以引用 QAnywhere .NET API 类。要使用 QAnywhere .NET API,您必须在源代码中添加一行以引用数据提供程序。必须为 C# 添加与 Visual Basic .NET 不同的语句行。

此外,您还必须初始化 QAnywhere .NET API。

♦  在 Visual Studio 项目中添加对 QAnywhere .NET API 的引用
  1. 启动 Visual Studio 并打开项目。

  2. 在 [Solution Explorer] 窗口中,右击 [References] 文件夹,然后选择 [Add Reference]。

  3. 在 [.NET] 选项卡上,单击 [Browse] 来查找 iAnywhere.QAnywhere.Client.dll。缺省位置为:

    • .NET Framework 2.0:install-dir\Assembly\v2
    • .NET Compact Framework 2.0:install-dir\ce\Assembly\v2

    选择 DLL 然后单击 [Open]。

  4. 可以验证 DLL 是否已添加到项目中。打开 [Add Reference] 窗口然后单击 [.NET] 选项卡。随即 iAnywhere.QAnywhere.Client.dll 出现在 [Selected Components] 列表中。单击 [OK] 关闭窗口。

在源代码中引用数据提供程序类
♦  在代码中引用 QAnywhere .NET API 类
  1. 启动 Visual Studio 并打开项目。

  2. 如果使用 C#,请将以下语句行添加到文件开始处的 using 指令列表中:

    using iAnywhere.QAnywhere.Client;
  3. 如果使用 Visual Basic,请将以下语句行添加到文件开始处的导入列表中:

    Imports iAnywhere.QAnywhere.Client
    

    并不严格要求使用该语句行。但是,它使您可以使用 QAnywhere 类的简写形式。即使没有该语句,您仍然可以在代码中使用完全限定的类名。例如:

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

    可代替

    QAManager mgr = QAManagerFactory.Instance.CreateQAManager(
     "qa_manager.props" );
♦  初始化 QAnywhere .NET API
  1. 包括 iAnywhere.QAnywhere.Client 命名空间,如上面的过程中所述。

    using iAnywhere.QAnywhere.Client;
  2. 创建 QAManager 对象。

    例如,要创建缺省的 QAManager 对象,可调用 CreateQAManager(以 null 作为其参数):

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

    为了提供最大并发数,多线程应用程序应为每个线程创建一个 QAManager。请参见多线程注意事项

    有关 QAManagerFactory 的详细信息,请参见QAManagerFactory 类

    也可以创建使用属性文件自定义的 QAManager 对象。属性文件在 CreateQAManager 方法中指定:

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

    其中,qa_mgr.props 是远程设备上属性文件的名称。

  3. 初始化 QAManager 对象。例如:

    mgr.Open(
       AcknowledgementMode.EXPLICIT_ACKNOWLEDGEMENT);

    open 方法的参数是确认模式,它指示确认消息的方式。它必须为 IMPLICIT_ACKNOWLEDGEMENT 或 EXPLICIT_ACKNOWLEDGEMENT。使用隐式确认时,客户端在收到消息时会进行确认。使用显式确认时,必须在 QAManager 上调用 Acknowledge 方法对消息进行确认。

    有关确认模式的详细信息,请参见AcknowledgementMode 枚举

现在,您就可以发送消息了。

注意

您可以创建 QATransactionalManager 而非 QAManager。请参见为 .NET 客户端实现事务性消息传递

另请参见