Functions.SqlColumns 方法 | |
将指定数据源表的列名列表及每列的信息存储到 X# 游标中。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION SqlColumns(
nStatementHandle AS LONG,
cTableName AS STRING,
cType AS STRING,
cCursorName AS STRING
) AS USUAL
public static __Usual SqlColumns(
int nStatementHandle,
[DefaultParameterValueAttribute("", 0)] string cTableName,
[DefaultParameterValueAttribute("FOXPRO", 0)] string cType,
[DefaultParameterValueAttribute("SQLRESULT", 0)] string cCursorName
)
查看代码参数
- nStatementHandle
- 类型:Int32
指定一个活动语句句柄。
- cTableName
- 类型:String
指定返回列名的表的名称。TableName 可以包含通配符字符 ? 和 *。 问号 (?) 匹配任何单个字符,星号 (*) 匹配任意数量的字符。
- cType
- 类型:String
指定结果集中列信息的格式。该值必须是 "Foxpro" 或 "Native"
Native 格式选项以与数据源相同的格式存储表的列信息。Foxpro 格式选项以与将数据源表导入 X# 时创建的 X# 表或游标相同的格式存储列信息。
Foxpro 或 Native,格式选项默认为 Foxpro。
备注部分显示了 Foxpro 格式的结果集中的列。
- cCursorName
- 类型:String
指定结果集的 X# 游标的名称。如果不包括游标名称,X# 使用默认名称 SQLRESULT。
返回值
类型:
__Usual
数值型或逻辑型。
SqlColumns( ) 如果游标成功创建,则返回 1;
如果
SqlColumns( ) 仍在执行,则返回 0;
如果发生连接级别错误,则返回 -1;
如果发生环境级别错误,则返回 -2。
备注 SqlColumns( ) 是四个可以同步或异步执行的函数之一。
SqlSetProp( ) 的异步设置决定这些函数是同步还是异步执行。
在异步模式下, 必须重复调用
SqlColumns( ) 直到返回除 false (.F.)(仍在执行)以外的值。
列名 | 描述 |
---|
Field_name | 列名 |
Field_type | 列数据类型 |
Field_len | 列长度 |
Field_dec | 小数位数 |
Native 格式的结果集中的列取决于数据源。
如果使用 cTableName 指定的表不存在且格式设置为 Native,
SqlColumns( ) 返回 true (.T.) 并创建一个空表或游标。
如果使用 cTableName 指定的表不存在且格式设置为 Foxpro,
SqlColumns( ) 返回 false (.F.)。
示例 1= SqlColumns(gnHandle, 'authors', 'Foxpro', 'MyCursor')
参见