Connection方法
HRESULT Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options )
参数
1. ConnectionString 可选,包含连接信息
2. UserID 可选,包含建立连接时所使用的用户名称
3. Password 可选,包含建立连接时所用密码
4. OpenOptions 可选,ConnectOptionEnum 值。如果设置为 adConnectAsync,则异步打开连接。adConnectUnspecified为默认选项,表示同步打开连接
_RecordsetPtr Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options )
参数
1. CommandText是命令字符串,通常是SQL命令,也可以是表名、存储过程等
2. RecordsAffected 可选,是操作完成后所影响的行数
3. Options 可选,解释CommandText参数的方式,Options可以是CommandTypeEnum或ExecuteOptionEnum枚举类型值
类型 |
说明 |
adCmdUnspecifed=-1 |
未描述CommandType属性 |
adCmdText=1 |
指示提供者应将 CommandText 赋值为命令的文本定义。 |
adCmdTableDirect |
指示提供者应从 CommandText 命名的表中返回所有行。 |
adCmdTable=2 |
指示提供者应将 CommandText 赋值为表名。 |
adCmdStoredProc=4 |
指示提供者应将 CommandText 赋值为存储过程。 |
adCmdUnknown=8 |
指示 CommandText 参数中的命令类型未知。 |
adExecuteAsync |
指示命令应该异步执行。 |
adFetchAsync |
指示 CacheSize 属性指定的初始数量之后的行应异步提取。 |
Command方法
_ RecordsetPtr Execute (VARIANT * RecordsAffected, VARIANT * Parameters,long Options)
参数
1. RecordsAffected 可选,返回受操作影响的记录数
2. Parameters 可选,包含所使用的具体参数,是一个VARIANT 类型数组
3. Options可选,指示提供程序如何解释CommandText属性,请参见Connection对象的Execute 方法
ParameterPtr CreateParameter(_bstr_t Nmae,enum DataTypeEnum Type,enum ParameterDirectionEnum Direction,ADO_LONGPTR size,const _variant_t &value)
Recordset方法
HRESULT Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )
参数
1. Source可选,指定记录集的源,可以是命令对象,SQL语句,表,存储过程等
2. ActiveConnection可选,可以是一个已经建立好的连接对象(我们需要用Connection对象指针来构造一个_variant_t对象) 或是一个包含连接信息的字符串
3. CursorType可选,游标类型,它可以是以下值之一,请看CursorTypeEnum这个枚举结构:
枚举值 |
说明 |
adOpenUnspecified = -1 |
不作特别指定 |
adOpenForwardOnly = 0 |
向前滚静态游标。这种游标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用 |
adOpenKeyset = 1 |
采用这种游标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 |
adOpenDynamic = 2 |
动态游标。所有数据库的操作都会立即在各用户记录集上反应出来。 |
adOpenStatic = 3 |
静态游标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。 |
4. LockType锁定类型,它可以是以下值之一,请看LockTypeEnum这个枚举结构:
枚举值 |
说明 |
adLockUnspecified = -1 |
未指定 |
adLockReadOnly = 1 |
只读记录集 |
adLockPessimistic = 2 |
悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制 |
adLockOptimistic = 3 |
乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作 |
adLockBatchOptimistic = 4 |
乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。 |
5. Options请参考本文中对Connection对象或Command对象的Execute方法的介绍
HRESULT Move (ADO_LONGPTR NumRecords,const _variant_t &start)
n adBookmarkCurrent
n adBookmardFirst
n adBookmarkLast
_RecordsetPtr NextRecordset(VARIANT *RecordsAffected)
HRESULT AddNew(const _varinat_t & FieldList,const _variant_t &values)
HRESULT Delete(enum AffectedEnum AffectRecords)
n adAffectCurrent
n adAffectGroup
n adAffectAll
HRESULT Update(const _variant_t &Fields,const _variant_t &values)
_variant_t GetRows(long Rows,const _variant_t &start,const _variant_t & Fields)
HRESULT Requery(long Options)