VC++程序员如何阅读ADO文档

// Note 1
inline void TESTHR( HRESULT _hr )
{ if FAILED(_hr) _com_issue_error(_hr); }

void main(void)
{
CoInitialize(NULL);
try
{
_RecordsetPtr pRs("ADODB.Recordset");
_ConnectionPtr pCn("ADODB.Connection");
_variant_t vtTableName("authors"),
vtCriteria;
long ix[1];
SAFEARRAY *pSa = NULL;

pCn->Open("DSN=pubs;User ID=sa;pwd=;Provider=MSDASQL;", "", "",
adConnectUnspecified);
// Note 2, Note 3
pSa = SafeArrayCreateVector(VT_VARIANT, 1, 4);
if (!pSa) _com_issue_error(E_OUTOFMEMORY);

// 为第三个元素赋值TABLE_NAME(索引值2).
ix[0] = 2;
TESTHR(SafeArrayPutElement(pSa, ix, &vtTableName));

// 由于Variant没有SafeArray的构造函数，所以手工设置Variant的数据类型和值。
vtCriteria.vt = VT_ARRAY | VT_VARIANT;
vtCriteria.parray = pSa;

pRs = pCn->OpenSchema(adSchemaColumns, vtCriteria, vtMissing);

long limit = pRs->GetFields()->Count;
for (long x = 0; x < limit; x++)
printf("%d: %s\n", x+1,
((char*) pRs->GetFields()->Item[x]->Name));
// Note 4
pRs->Close();
pCn->Close();
}
catch (_com_error &e)
{
printf("Error:\n");
printf("Code = %08lx\n", e.Error());
printf("Code meaning = %s\n", (char*) e.ErrorMessage());
printf("Source = %s\n", (char*) e.Source());
printf("Description = %s\n", (char*) e.Description());
}
CoUninitialize();
}

使用属性的Get/Put/PutRef

　　在VB中，属性的名称并未被检验，无论它是被读取、被赋值，或者赋予一个引用。

Public Sub GetPutPutRef
Dim rs As New ADODB.Recordset
Dim cn As New ADODB.Connection
Dim sz as Integer
cn.Open "Provider=sqloledb;Data Source=yourserver;" & _
"Initial Catalog=pubs;User Id=sa;Password=;"
rs.PageSize = 10
sz = rs.PageSize
rs.ActiveConnection = cn
rs.Open "authors",,adOpenStatic
'''' ...
rs.Close
cn.Close
End Sub

以下是VC++关于Get/Put/PutRefProperty的演示

　　1．这个例子演示了省略字符串参数的两种形式：一种是采用常量strMissing，另一种则是由编译器自动生成一个临时的存在于Open方法使用期间的_bstr_t。

　　2．因为操作数已经是(IDispatch *)的指针，所以没有必要将rs->PutRefActiveConnection(cn)的操作数再进行类型转换。

#import "c:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")
#include <stdio.h>

void main(void)
{
CoInitialize(NULL);
try
{
_ConnectionPtr cn("ADODB.Connection");
_RecordsetPtr rs("ADODB.Recordset");
_bstr_t strMissing(L"");
long oldPgSz = 0,
newPgSz = 5;

// Note 1
cn->Open("Provider=sqloledb;Data Source=a-tima10;"
"Initial Catalog=pubs;User Id=sa;Password=;",
strMissing, "",
adConnectUnspecified);

oldPgSz = rs->GetPageSize();
// -or-
oldPgSz = rs->PageSize;

rs->PutPageSize(newPgSz);
// -or-
rs->PageSize = newPgSz;

// Note 2
rs->PutRefActiveConnection( cn );
rs->Open("authors", vtMissing, adOpenStatic, adLockReadOnly,
adCmdTable);
printf("Original pagesize = %d, new pagesize = %d\n", oldPgSz,
rs->GetPageSize());
rs->Close();
cn->Close();
}
catch (_com_error &e)
{
printf("Description = %s\n", (char*) e.Description());
}
::CoUninitialize();
} 

使用GetItem(x)和Item[x]

　　下面是VB中关于Item()的标准与交互语法的演示。

Public Sub GetItemItem
Dim rs As New ADODB.Recordset
Dim name as String
rs = rs.Open "authors", "DSN=pubs;", adOpenDynamic, _
adLockBatchOptimistic, adTable
name = rs(0)
'''' -or-
name = rs.Fields.Item(0)
rs(0) = "Test"
rs.UpdateBatch
'''' Restore name
rs(0) = name
rs.UpdateBatch
rs.Close
End Sub

以下则是VC++关于Item的演示

　　当访问collection中的Item时，索引值2必须被转换为long类型以确保正确的构造函数被调用。

#import "c:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")
#include <stdio.h>

void main(void)
{
CoInitialize(NULL);
try {
_RecordsetPtr rs("ADODB.Recordset");
_variant_t vtFirstName;

rs->Open("authors",
"Provider=sqloledb;Data Source=a-tima10;"
"Initial Catalog=pubs;User Id=sa;Password=;",
adOpenStatic, adLockOptimistic, adCmdTable);
rs->MoveFirst();

// Note 1.取得一个字段的名称
vtFirstName = rs->Fields->GetItem((long)2)->GetValue();
// -or-
vtFirstName = rs->Fields->Item[(long)2]->Value;

printf( "First name = ''''%s''''\n", (char*) ((_bstr_t) vtFirstName));

rs->Fields->GetItem((long)2)->Value = L"TEST";
rs->Update(vtMissing, vtMissing);

// 恢复原名称
rs->Fields->GetItem((long)2)->PutValue(vtFirstName);
// -or-
rs->Fields->GetItem((long)2)->Value = vtFirstName;
rs->Update(vtMissing, vtMissing);
rs->Close();
}
catch (_com_error &e)
{
printf("Description = ''''%s''''\n", (char*) e.Description());
}
::CoUninitialize();
}
 
利用(IDispatch *)转换ADO对象的指针类型

　　1．在一个Variant中显式地封装一个活动的Connection对象，然后用(IDispatch *)进行类型转换确保正确的构造函数被调用。同时明确地设置第二个参数为缺省的true，使该对象的引用计数在Recordset::Open操作完成后仍得到正确的维护。

　　2．表达式(_bstr_t)不是一个类型转换，而是一个_variant_t的操作符，用以从中提取一个_bstr_t字符串。

　　表达式(char*)也不是一个类型转换，而是一个_bstr_t的操作符，用以从中提取封装在_bstr_t中的字符串的指针。

　　下面这些代码演示了_variant_t和_bstr_t的一些常见操作。

#import "c:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")

#include <stdio.h>

void main(void)
{
CoInitialize(NULL);
try
{
_ConnectionPtr pConn("ADODB.Connection");
_RecordsetPtr pRst("ADODB.Recordset");

pConn->Open("Provider=sqloledb;Data Source=a-tima10;"
"Initial Catalog=pubs;User Id=sa;Password=;",
"", "", adConnectUnspecified);
// Note 1
pRst->Open(
"authors",
_variant_t((IDispatch *) pConn, true),
adOpenStatic,
adLockReadOnly,
adCmdTable);
pRst->MoveLast();
// Note 2
printf("Last name is ''''%s %s''''\n",
(char*) ((_bstr_t) pRst->GetFields()->GetItem("au_fname")->GetValue()),
(char*) ((_bstr_t) pRst->Fields->Item["au_lname"]->Value));

pRst->Close();
pConn->Close();
}
catch (_com_error &e)
{
printf("Description = ''''%s''''\n", (char*) e.Description());
}
::CoUninitialize();
}
 

　　对于VC++程序员而言，每次都要将ADO返回的数据转换成一般的C++数据类型，接着将数据存入一个类或结构总是一件枯燥的事。更讨厌的是这也带来了效率的低下。

　　因此，ADO提供了一个接口以支持将数据直接返回为一个本地化的C/C++数据类型而非VARIANT，并提供了一系列的预处理宏来方便使用这些接口。这样做的结果是一个复杂的工具可以很轻松的被使用并能获得很好的性能。

　　一个普通的C/C++客户场景是将一个Recordset中的一条记录绑定到一个包含本地C/C++数据类型的C/C++结构或类之上。如果通过Variant传递数据，这意味着要编写大量的转换代码，以在VARIANT和C/C++本地类型间进行数据转换。VC++对ADO的扩展出现的目的就是要简化这一过程。

如何使用VC++对ADO的扩展

　　IADORecordBinding接口

　　VC++对ADO的扩展联系或绑定了一个Recordset对象的各个字段到C/C++变量。当被绑定的Recordset的当前行改变时，其中所有被绑定的字段的值也同样会被拷贝到相应的C/C++变量中。如果需要，被拷贝的数据还会自动进行相应的数据类型转换。

　　IADORecordBinding接口的BindToRecordset方法将字段绑定到C/C++变量之上。AddNew方法则是增加一个新的行到被绑定的Recordset。Update方法利用C/C++变量的值填充Recordset中新的行或更新已存在的行。
IADORecordBinding接口由Recordset对象实现，你不需要自己编码进行实现。

　　绑定条目

　　VC++对ADO的扩展在一个Recordset对象与一个C/C++变量间进行映像（Map）。一个字段与对应的一个变量间的映像被称作一个绑定条目。预定义的宏为数字、定长或不定长数据提供了绑定条目。所有的绑定条目与相应的C/C++变量都被封装、声明在一个从VC++扩展类CADORecordBinding派生的类中。这个CADORecordBinding类在内部由绑定条目宏定义。

　　在ADO内部，将所有宏的参数都映射在一个OLE DB DBBINDING结构中，并创建一个OLE DB访问子（Accessor）对象来管理所有的行为和字段与变量间的数据转换。OLE DB定义的数据由以下三部分组成：存储数据的缓冲区；一个状态值表示一个字段是否被成功地被存入缓冲区，或变量值是否被成功地存入字段；数据长度。（参见OLE DB程序员参考第6章：读写数据的更多信息）

　　所需的头文件

　　为了使用VC++对ADO的扩展，你得在你的应用中包含这个头文件：#include <icrsint.h>

　　绑定Recordset的字段

　　要绑定Recordset的字段到C/C++变量，需要这样做：

　　1．创建一个CADORecordsetBinding的派生类。

　　2．在派生类中定义绑定条目和相应的C/C++变量。注意不要使用逗号、分号切断宏。每个宏都会自动地定义适当的分隔符。

　　为每个被映像的字段定义一个绑定条目。并注意根据不同情况选用ADO_FIXED_LENGTH_ENTRY、 ADO_NUMERIC_ENTRY、ADO_VARIABLE_LENGTH_ENTRY中的某个宏。

　　3．在你的应用中，创建一个该派生类的实例。从Recordset中获得IADORecordBinding接口，然后调用BindToRecordset方法将Recordset的所有字段绑定到对应的C/C++变量之上。

　　请参见示例程序以获得更多信息。

　　接口方法

　　IADORecordBinding接口只有三个方法：BindToRecordset, AddNew,和Update。每个方法所需的唯一的参数就是一个CADORecordBinding派生类的实例指针。因此，AddNew和Update方法不能使用任何与它们同名的ADO方法中的参数。

　　语法

　　BindToRecordset方法将字段绑定到C/C++变量之上。

BindToRecordset(CADORecordBinding *binding)

　　AddNew方法则引用了它的同名ADO函数，来增加一个新的记录行。

AddNew(CADORecordBinding *binding)

　　Update方法也引用了它的同名ADO函数，来更新Recordset。

Update(CADORecordBinding *binding)

　　绑定条目宏

　　绑定条目宏定义了一个Recordset字段与一个变量间的对应关系。每个条目的绑定宏由开始宏与结束宏组成并配对使用。

　　定长数据的宏适用于adDate，adBoolean等，数字的宏适用于adTinyInt, adInteger和adDouble等，变长数据的宏适用于adChar, adVarChar和adVarBinary等。所有的数字类型，除了adVarNumeric以外也是定长数据类型。每个宏的族之间都有不同的参数组，因此你可以排除不感兴趣的绑定信息。

　　参见OLE DB程序员参考附录A：数据类型的更多信息

开始绑定条目

BEGIN_ADO_BINDING(Class)

定长数据：

ADO_FIXED_LENGTH_ENTRY(Ordinal, DataType, Buffer, Status, Modify)
ADO_FIXED_LENGTH_ENTRY2(Ordinal, DataType, Buffer, Modify)

数字型数据：

ADO_NUMERIC_ENTRY(Ordinal, DataType, Buffer, Precision, Scale, Status, Modify)
ADO_NUMERIC_ENTRY2(Ordinal, DataType, Buffer, Precision, Scale, Modify)

变长数据：

ADO_VARIABLE_LENGTH_ENTRY(Ordinal, DataType, Buffer, Size, Status, Length, Modify)
ADO_VARIABLE_LENGTH_ENTRY2(Ordinal, DataType, Buffer, Size, Status, Modify)
ADO_VARIABLE_LENGTH_ENTRY3(Ordinal, DataType, Buffer, Size, Length, Modify)
ADO_VARIABLE_LENGTH_ENTRY4(Ordinal, DataType, Buffer, Size, Modify)

结束绑定

END_ADO_BINDING()

参数    描述
Class    派生类的名字。
Ordinal   从1开始的序号，对应于Recordset中的字段。
DataType   与C/C++变量对应的ADO数据类型(参见DataTypeEnum以获得有效数据类型的列表)。如果需要，字段的值会被转换成该类型的值。
Buffer    对应的C/C++变量的名字。
Size    该C/C++变量的最大字节数。如果是个变长字符串，使用0表示即可。
Status    指示变量的名字。该变量用以表示缓冲是否有效，数据转换是否成功。值adFldOK意味着转换成功；adFldNull意味着该字段的值为空。其他可能的值见后面的状态值列表。
Modify    逻辑标志。TRUE意味着ADO允许利用变量值更新Recordset中的字段的值。设置该值为TRUE将允许更新，如果你只想检查字段的值而不想改变它那么就设置为FALSE。
Precision   数字型变量的位数。
Sc

上一页  [1] [2] [3]  下一页

Copyright ＠ 2007-2012 敏韬网(敏而好学，文韬武略--MinTao.Net)（学习笔记） Inc All Rights Reserved.
闵涛 E_mail:admin@mintao.net(欢迎提供学习资源)

鄂公网安备 42011102001154号

站长：MinTao ICP备案号：鄂ICP备11006601号-18