《ADO API参考》用VB的语法描述了ADO API的内容。但ADO程序员却使用着不同的编程语言，比如VB,VC++，VJ++。对此《ADO for VC++的语法索引》提供了符合VC++语法规范的详细描述，包括功能、参数、异常处理等等。

ADO基于若干的COM借口实现，因此它的使用对于一个正进行COM编程的程序员而言更简单。比如，几乎所有使用COM的细节对于VB程序员而言都是隐藏了的，但对于VC++程序员而言却要特别注意。以下是对于C和C++程序员使用ADO和#import指示符方面的概述，主要描述了COM使用的数据类型(Variant, BSTR, and SafeArray)和异常的处理(_com_error)。



使用#import编译指示符

#import编译指示符使使用ADO的方法与属性简单化。这个指示符需要一个类型库文件名，比如ADO.dll(Msado15.dll)，并生成对应的头文件，其中包括定义的类型、接口的智能化指针、常量。并且所有的接口都被封装成类。

对于类中的每个操作（或称方法、属性调用），都有一个声明以保证能直接调用它（或称作操作的源形式），以及另一个声明来调用这个源操作并在操作失败时抛出一个COM错误。如果操作是一个属性，那么编译指示符可以为该操作创建一个可交互的类似VB的语法形式。

返回/设置属性的操作有对应的形式化的名字—GetProperty/PutPropert，而设置一个指向某个ADO对象的指针型属性值时则是PutRefProperty。你将使用如下的形式读写属性的值：

variable = objectPtr->GetProperty(); // 读取属性的值

objectPtr->PutProperty(value);       // 设置属性的值

objectPtr->PutRefProperty(&value);   // 设置一个指针型的属性的值



直接使用属性

__declspec(property)编译指示符是微软定义的一个针对C语言的扩展，使一个函数象一个属性那样被使用。这样你就可以采用如下的语法形式象在使用VB一样读写一个属性的值： objectPtr->property = value;        // 设置属性的值

variable = objectPtr->property;     // 读取属性的值

__declspec(property)编译指示符只能针对属性的读写函数使用，并根据属性是否可供读写自动生成对应的调用形式。每个属性可能有GetProperty, PutProperty,PutRefProperty三个函数，但这个编译符只能生成其中的两种交互形式。比如，Command对象的ActiveConnection属性有GetActiveConnection和PutRefActiveConnection这两个读写函数。而PutRef-的形式在实践中是个好的选择，你可以将一个活动的Connection对象的指针保存在这个属性中。另一方面，Recordset对象则有Get-, Put-, and PutRefActiveConnection操作，但却没有可交互的语法形式。



Collections,GetItem方法和Item属性

ADO定义了几种集合Collection，包括Fields,Parameters,Properties,和Errors。在Visual C++中，GetItem(index)方法返回Collection中的某个成员。Index是一个Variant型的参数，内容可以是一个该成员对应的序数，也可以是一个包括其名称的字符串。

__declspec(property)编译指示符为Item属性生成对应于GetItem()方法的直接使用形式（上文提到的可交互的语法形式）。这种形式类似于引用数组元素时使用的语法形式：

collectionPtr->GetItem(index);

collectionPtr->Item[index];

举例说明，要给一个Recordset对象rs中的某个字段赋值，而这个Recordset对象派生于pubs数据库中的authors表。使用Item()属性访问这个Recordset的Fields集合中的第三个字段（集合总是从0开始编号，假设第三个字段名为au_fname）。然后调用Value()方法为该字段赋一个字符串值。

Visual Basic的语法形式：

rs.Fields.Item(2).Value = "