SQLSETPROP() 函 数

SQLSETPROP() 函 数 - 图1指定一个活动连接的设置

语 法

SQLSETPROP ( nConnectionHandle , cSetting [, eExpression ])

参 数 描 述

nConnectionHandle

SQLSETPROP() 函 数 - 图2SQLSETPROP() 函 数 - 图3由 SQLCONNECT ( ) 返 回 的 指 向 数 据 源 的 连 接 句 柄

cSetting

SQLSETPROP() 函 数 - 图4SQLSETPROP() 函 数 - 图5指 定 设 置 下 表 列 出 了 cSetting 的 值

SQLSETPROP() 函 数 - 图6SQLSETPROP() 函 数 - 图7SQLSETPROP() 函 数 - 图8设 置 说 明

Asynchronous 指定结果集合是同步返回 默认值为 假 (.F.)) 还是异步返回

SQLSETPROP() 函 数 - 图9SQLSETPROP() 函 数 - 图10SQLSETPROP() 函 数 - 图11SQLSETPROP() 函 数 - 图12SQLSETPROP() 函 数 - 图13SQLSETPROP() 函 数 - 图14( 真 (.T.) 可读写

SQLSETPROP() 函 数 - 图15SQLSETPROP() 函 数 - 图16SQLSETPROP() 函 数 - 图17BatchMode 指定 SQLEXEC ( ) 是一次返回全部结果集合 默认值为 真

SQLSETPROP() 函 数 - 图18SQLSETPROP() 函 数 - 图19SQLSETPROP() 函 数 - 图20SQLSETPROP() 函 数 - 图21SQLSETPROP() 函 数 - 图22SQLSETPROP() 函 数 - 图23SQLSETPROP() 函 数 - 图24SQLSETPROP() 函 数 - 图25(.T.) 还是用 SQLMORERESULTS ( ) 单个返回结果集合假 (.F.) 可读写

SQLSETPROP() 函 数 - 图26SQLSETPROP() 函 数 - 图27SQLSETPROP() 函 数 - 图28SQLSETPROP() 函 数 - 图29SQLSETPROP() 函 数 - 图30SQLSETPROP() 函 数 - 图31SQLSETPROP() 函 数 - 图32SQLSETPROP() 函 数 - 图33ConnectBusy 如果共享连接繁忙 为 真 (.T.) 否则为 假 (.F.) 只读

SQLSETPROP() 函 数 - 图34SQLSETPROP() 函 数 - 图35ConnectString 注册的连接字符串 只读

SQLSETPROP() 函 数 - 图36SQLSETPROP() 函 数 - 图37SQLSETPROP() 函 数 - 图38SQLSETPROP() 函 数 - 图39SQLSETPROP() 函 数 - 图40SQLSETPROP() 函 数 - 图41SQLSETPROP() 函 数 - 图42ConnectTimeOut 指定返回一个连接超时错误之前的等待时间 SQLSETPROP() 函 数 - 图43 以秒计算 SQLSETPROP() 函 数 - 图44 如 果指定为 0 默认值 将无限期等待 ,而不会返回超时错误ConnectTimeOut 可以是以 0 到 600 可读写

SQLSETPROP() 函 数 - 图45SQLSETPROP() 函 数 - 图46DataSource 和 ODBC.INI 文件中相同的数据源文件名 可读写

续 表

SQLSETPROP() 函 数 - 图47SQLSETPROP() 函 数 - 图48SQLSETPROP() 函 数 - 图49SQLSETPROP() 函 数 - 图50DispLogin 包含一个数值 决定什么时候显示 ODBC 注册 对话框

SQLSETPROP() 函 数 - 图51DispLogin 可以设定为下列值

  1. SQLSETPROP() 函 数 - 图52SQLSETPROP() 函 数 - 图53SQLSETPROP() 函 数 - 图54

    DB_PROMPTCOMPLETE 在 FOXPRO.H 中定义 1 是默

SQLSETPROP() 函 数 - 图55认值

  1. SQLSETPROP() 函 数 - 图56SQLSETPROP() 函 数 - 图57SQLSETPROP() 函 数 - 图58

    DB_PROMPTALWAYS 在 FOXPRO.H 中定义

  2. SQLSETPROP() 函 数 - 图59SQLSETPROP() 函 数 - 图60SQLSETPROP() 函 数 - 图61

    DB_PROMPTNEVER 在 FOXPRO.H 中定义

SQLSETPROP() 函 数 - 图62SQLSETPROP() 函 数 - 图63SQLSETPROP() 函 数 - 图64SQLSETPROP() 函 数 - 图65SQLSETPROP() 函 数 - 图66如果指定为 1 或 DB_ PROMPTCOMPLETE 则当需要的信息未得到时 总是显示 ODBC 注册 对话框

SQLSETPROP() 函 数 - 图67SQLSETPROP() 函 数 - 图68如果指定为 2 或 DB_ PROMPTALWAYS 则总是显示 ODBC

SQLSETPROP() 函 数 - 图69SQLSETPROP() 函 数 - 图70SQLSETPROP() 函 数 - 图71注册 对话框 允许连接前更改设置

SQLSETPROP() 函 数 - 图72SQLSETPROP() 函 数 - 图73如果指定为 3 或 DB_ PROMPTNEVER 则不显示 ODBC 注

SQLSETPROP() 函 数 - 图74SQLSETPROP() 函 数 - 图75SQLSETPROP() 函 数 - 图76SQLSETPROP() 函 数 - 图77册 对话框并且当所需要的注册内容不可用时 Visual FoxPro 产生错误 可读写

SQLSETPROP() 函 数 - 图78SQLSETPROP() 函 数 - 图79SQLSETPROP() 函 数 - 图80SQLSETPROP() 函 数 - 图81SQLSETPROP() 函 数 - 图82DispWarnings DispWarnings 指定要显示错误信息 真 (.T.) 还是不显示

SQLSETPROP() 函 数 - 图83SQLSETPROP() 函 数 - 图84SQLSETPROP() 函 数 - 图85SQLSETPROP() 函 数 - 图86SQLSETPROP() 函 数 - 图87SQLSETPROP() 函 数 - 图88SQLSETPROP() 函 数 - 图89错误信息 假 (.F.) 默认值 可 读 写

SQLSETPROP() 函 数 - 图90SQLSETPROP() 函 数 - 图91SQLSETPROP() 函 数 - 图92SQLSETPROP() 函 数 - 图93SQLSETPROP() 函 数 - 图94SQLSETPROP() 函 数 - 图95SQLSETPROP() 函 数 - 图96IdleTimeout 以秒计算的空闲超时间隔 在指定的时间间隔之后 活动的连接成为不活动的 默认值是 0 无限期等待 可读写

SQLSETPROP() 函 数 - 图97SQLSETPROP() 函 数 - 图98SQLSETPROP() 函 数 - 图99ODBChdbc 内部 ODBC 连接句柄 外部库文件 FLL 文件 在调用 ODBC 时

SQLSETPROP() 函 数 - 图100SQLSETPROP() 函 数 - 图101使用该句柄 只读

SQLSETPROP() 函 数 - 图102SQLSETPROP() 函 数 - 图103SQLSETPROP() 函 数 - 图104SQLSETPROP() 函 数 - 图105SQLSETPROP() 函 数 - 图106ODBChstmt 内部 ODBC 语句句柄 外部库文件 FLL 文件 在调用 ODBC 时使用该句柄 只读

SQLSETPROP() 函 数 - 图107SQLSETPROP() 函 数 - 图108PacketSize 连接所用的网络包的大小 调整该值可以改善性能 默认值是

SQLSETPROP() 函 数 - 图109SQLSETPROP() 函 数 - 图1104096 字节 (4K) 可读写

SQLSETPROP() 函 数 - 图111SQLSETPROP() 函 数 - 图112Password 连接密码 只读

续 表

SQLSETPROP() 函 数 - 图113SQLSETPROP() 函 数 - 图114SQLSETPROP() 函 数 - 图115SQLSETPROP() 函 数 - 图116SQLSETPROP() 函 数 - 图117SQLSETPROP() 函 数 - 图118SQLSETPROP() 函 数 - 图119SQLSETPROP() 函 数 - 图120QueryTimeOut 指定在返回一般超时错误之前等待的时间 以秒计算 如果指定为 0 将无限期等待而不会返回超时错误 QueryTimeOut 可以是 0 到 600 默认值是 15 可读写

SQLSETPROP() 函 数 - 图121SQLSETPROP() 函 数 - 图122Transactions 包含一个数值 该数值决定连接如何管理远程表上的事务处理

SQLSETPROP() 函 数 - 图123Transactions 可以设定为下列值

  1. SQLSETPROP() 函 数 - 图124SQLSETPROP() 函 数 - 图125

    DB_TRANSAUTO 在 FOXPRO.H 中定义

SQLSETPROP() 函 数 - 图126SQLSETPROP() 函 数 - 图127.1 是默认值 自动处理远程表的事务

  1. SQLSETPROP() 函 数 - 图128SQLSETPROP() 函 数 - 图129SQLSETPROP() 函 数 - 图130

    DB_TRANSMANUL 在 FOXPRO.H 中定义 通过

SQLSETPROP() 函 数 - 图131SQLSETPROP() 函 数 - 图132SQLCOMMIT ( ) 和 SQLROLLBACK( ). 人工处理事务 可读写

SQLSETPROP() 函 数 - 图133SQLSETPROP() 函 数 - 图134UserId 用户标识 只读

WaitTime 在 Visual FoxPro 检查 SQL 语句是否结束执行之前延迟的以毫秒

SQLSETPROP() 函 数 - 图135SQLSETPROP() 函 数 - 图136SQLSETPROP() 函 数 - 图137计的时间值 默认值是 100 毫秒 可读写

eExpression

SQLSETPROP() 函 数 - 图138SQLSETPROP() 函 数 - 图139SQLSETPROP() 函 数 - 图140cSetting 标 明 的 设 置 值 如 果 省 略 了 eExpression 参 数 则 还 原 成 默 认 值

SQLSETPROP() 函 数 - 图141返 值 类 型数值型 说 明

SQLSETPROP() 函 数 - 图142SQLSETPROP() 函 数 - 图143SQLSETPROP() 函 数 - 图144SQLSETPROP() 函 数 - 图145SQLSETPROP() 函 数 - 图146如果调用成功 SQLSETPROP ( ) 返回 1 否则 如果发生连接级错误则返回 -1 发生环境级错误则返回 -2

SQLSETPROP() 函 数 - 图147SQLSETPROP() 函 数 - 图148SQLSETPROP() 函 数 - 图149使用 SQLSETPRO P( ) 在连接级上指定设置 若要在环境级指定 Visual FoxPro 默认设置 用 0 作为连接句柄

SQLSETPROP() 函 数 - 图150SQLSETPROP() 函 数 - 图151ConnectTimeOut 选项只能在 Visual FoxPro 级上设置 而不能在连接级上使用 所有其

SQLSETPROP() 函 数 - 图152SQLSETPROP() 函 数 - 图153SQLSETPROP() 函 数 - 图154他选项既可在连接级 也可在 Visual FoxPro 级上进行设置 每个在 Visual FoxPro 级的设置作为随后连接的默认值

SQLSETPROP() 函 数 - 图155可用 SQLGETPRO P( ) 返回指定设置的当前值

SQLSETPROP() 函 数 - 图156SQLSETPROP() 函 数 - 图157SQLSETPROP() 函 数 - 图158SQLSETPROP() 函 数 - 图159注意 为了支持 Microsoft Transaction Server 的 SQL pass-through 功能 必 须 废 止 ODBC 登录对话框 使用 SQLSETPROP( cConnectionHandle , 'DispLogin', 3) 可以废止 ODBC 登录对话框 cConnectionHandle 是 SQLCONNECT 返回的连接句

SQLSETPROP() 函 数 - 图160SQLSETPROP() 函 数 - 图161SQLSETPROP() 函 数 - 图162柄 也可以在连接设计器中废止 ODBC 登录对话框

示 例

SQLSETPROP() 函 数 - 图163用 SQLSETPROP( ) 为当前连接设置数据包大小

*清除环境 * CLOSE ALL CLEAR ALL CLEAR

  • 显示选择的连接和数据源对话框

  • to choose a connection nHandle=SQLCONNECT()

SQLSETPROP() 函 数 - 图164*检测连接 报告结果

IF nHandle > 0

  • Set PacketSize

nSet= SQLSETPROP (nHandle, "PacketSize", 2048 )

  • Test 设置 and display results IF nSet > 0

=MESSAGEBOX("PacketSize was set to 2048",0,"Connection Results") ELSE

=MESSAGEBOX("Error Setting PacketSize",0,"Connection Results")

ENDIF ELSE

=MESSAGEBOX("No Connection",0,"Connection Results") ENDIF

=SQLDISCONNECT(nHandle)

请 参 阅

AERROR ( ), SQLGETPROP( )