X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
XSharp.VO.SDK
DbServer 类
DbServer 方法
Append 方法
AppendDB 方法
AppendDelimited 方法
AppendSDF 方法
Average 方法
BLOBDirectExport 方法
BLOBDirectGet 方法
BLOBDirectImport 方法
BLOBDirectPut 方法
BLOBExport 方法
BLOBGet 方法
BLOBImport 方法
BLOBRootGet 方法
BLOBRootLock 方法
BLOBRootPut 方法
BLOBRootUnlock 方法
ClearFilter 方法
ClearIndex 方法
ClearLocate 方法
ClearOrderScope 方法
ClearRelation 方法
ClearScope 方法
Close 方法
Commit 方法
ConstructUniqueAlias 方法
Continue 方法
CopyDB 方法
CopyDelimited 方法
CopySDF 方法
CopyStructure 方法
Count 方法
CreateIndex 方法
CreateOrder 方法
DataField 方法
Delete 方法
DeleteAll 方法
DeleteOrder 方法
Error 方法
Eval 方法
FieldGet 方法
FieldGetBytes 方法
FieldGetFormatted 方法
FieldHyperLabel 方法
FieldInfo 方法
FieldName 方法
FieldPos 方法
FieldPut 方法
FieldPutBytes 方法
FieldSpec 方法
FieldStatus 方法
FieldSym 方法
FieldValidate 方法
FLock 方法
GetArray 方法
GetLocate 方法
GetLookupTable 方法
GoBottom 方法
GoTo 方法
GoTop 方法
IndexKey 方法
IndexOrd 方法
Info 方法
Join 方法
Locate 方法
LockCurrentRecord 方法
LockSelection 方法
NoIVarGet 方法
NoIVarPut 方法
Notify 方法
OrderDescend 方法
OrderInfo 方法
OrderIsUnique 方法
OrderKeyAdd 方法
OrderKeyCount 方法
OrderKeyDel 方法
OrderKeyGoTo 方法
OrderKeyNo 方法
OrderScope 方法
OrderSkipUnique 方法
Pack 方法
RddInfo 方法
Recall 方法
RecallAll 方法
RecordInfo 方法
Refresh 方法
Reindex 方法
Relation 方法
Replace 方法
ResetNotification 方法
RLock 方法
RLockVerify 方法
Seek 方法
Select 方法
SetDataField 方法
SetFilter 方法
SetIndex 方法
SetOrder 方法
SetOrderCondition 方法
SetRelation 方法
SetSelectiveRelation 方法
Skip 方法
Sort 方法
Sum 方法
SuspendNotification 方法
Total 方法
UnLock 方法
Update 方法
Zap 方法
点击或拖拽改变大小

DbServer.FieldInfo 方法

X#
返回并可选更改有关字段的信息。

命名空间：  XSharp.VO.SDK
程序集：  XSharp.VORDDClasses (在 XSharp.VORDDClasses.dll 中) 版本：2.22 GA
语法
复制
 VIRTUAL METHOD FieldInfo(
	kFieldInfoType,
	uField,
	uFieldVal
) AS USUAL CLIPPER
查看代码

参数

kFieldInfoType (Optional)
类型：__Usual
指定信息类型。常量在下面的备注部分中描述。请注意，并非所有常量都支持所有 RDD。
uField (Optional)
类型：__Usual
表示字段在数据库文件结构中的位置的名称、编号或符号，或指向 BLOB 的数字指针。 仅某些设计用于与 BLOB 字段一起使用的 kFieldInfoType 常量(在下面的常量部分中均有说明)允许使用指针指定字段； 所有其他常量都要求按位置指定字段。
uFieldVal (Optional)
类型：__Usual
如果指定，此参数用于更改设置的值。数据类型(以及是否可以指定 uNewSetting)， 取决于 kInfoType 常量，并在下面的常量部分中记录。

返回值

类型：__Usual
如果未指定 uNewSetting，DBServer:FieldInfo() 返回当前设置。 如果指定了 uNewSetting，则返回先前的设置。
备注
常量描述
DBS_ALIAS 返回并可选地更改一个字段可以被引用的备用名称（或别名）（默认情况下，与 DBS_NAME 相同）。 使用 uNewSetting 参数，您可以指定一个字符串，随后可以使用该字符串来访问指定的字段。
DBS_BLOB_DIRECT_LEN 以无符号长整数的形式返回 BLOB 中的数据长度，而不引用特定的备注字段。对于字符串，返回值是字符串的字节长度； 对于数组，它是第一维中的元素数；对于所有其他数据类型，它返回 -1。 使用此常量，您必须使用 BLOBDirectPut()、BLOBDirectImport() 或 FieldInfo(DBS_BLOB_POINTER, ...) 获取的数值指针来指定 BLOB。
DBS_BLOB_DIRECT_TYPE 用于确定 BLOB 数据类型，而不引用特定的备注字段。使用 DBS_BLOB_DIRECT_TYPE。使用此常量，您必须使用 BLOBDirectPut()、BLOBDirectImport() 或 FieldInfo(DBS_BLOB_POINTER, ...) 获取的数值指针来指定 BLOB。
请参阅 DBS_BLOB_TYPE 以获取可能的返回值的表。
DBS_BLOB_LEN 以无符号长整数的形式返回备注字段中的 BLOB 数据的长度。对于字符串，返回值是字符串的字节长度；对于数组，它是第一维中的元素数；对于所有其他数据类型，它返回 -1。
提示 提示：
使用 DBS_BLOB_LEN 优于检索值并使用 Len() 函数。
DBS_BLOB_POINTER返回与备注字段关联的 BLOB 数据的数值指针。
DBS_BLOB_TYPE 与在 .DBT 文件中维护的备注字段不同，BLOB 文件允许您在备注字段中存储许多不同类型的数据。然而，用于确定数据类型的标准函数，如 ValType()，简单地将 BLOB 字段视为常规备注字段。要确定备注字段中存储的实际 BLOB 数据的类型，使用 DBS_BLOB_TYPE。
返回值的数据类型是字符串，可以使用此表进行解释：
返回值含义
?空（未初始化的字段）
A数组
C字符串
D日期
E错误
L逻辑
N数值
U未定义（NIL 已存储）
DBS_DEC返回字段的小数位数。
DBS_LEN返回字段的长度。
DBS_NAME返回字段的名称。
DBS_PROPERTIES返回字段定义的属性数。
DBS_TYPE返回字段的数据类型。
DBS_USER用户定义值的开始。
提示 提示：
DBS_USER 是一个常量，返回第三方 RDD 开发人员可以用于自定义的最小值。 小于 DBS_USER 的值保留给 X# 开发。
DBServer:FieldInfo() 检索有关字段(列)状态的信息。 可用的字段信息由 RDD 定义。在 DBF 模型中，这仅限于存储在 DBF 文件结构中的信息(即名称、长度、小数位数和数据类型)以及可以在运行时更改的字段别名。 为了支持其他数据库模型(例如基于字典的数据库)的 RDD，这些模型存储有关每个字段或列的更多信息， X# RDD API 已得到增强。DBServer:FieldInfo() 方法设计为允许由第三方 RDD 开发人员定义的其他 kInfoType 值。
示例
以下示例使用 DBServer:FieldInfo() 检索字段信息：
X#
复制
 1METHOD DBOutStruct() CLASS Customer
 2LOCAL aStruct AS ARRAY
 3LOCAL wFcount AS DWORD
 4LOCAL i AS DWORD
 5
 6aStruct := {}
 7wFcount := FCount()
 8
 9FOR i := 1 UPTO wFcount
10AAdd(aStruct,;
11{SELF:FieldInfo(DBS_NAME, i),;
12SELF:FieldInfo(DBS_TYPE, i),;
13SELF:FieldInfo(DBS_LEN, i),;
14SELF:FieldInfo(DBS_DEC, i)})
15NEXT
16
17RETURN aStruct
下一个示例说明了使用第三个参数为字段名称分配别名：
X#
复制
1METHOD Start() CLASS App
2LOCAL oDBDate AS DBServer
3oDBDate := DateBook{}
4oDBDate:FieldInfo(DBS_ALIAS,;
5oDBDate:FieldPos("Name"),;
6"NewName")
7? Name // 显示名称字段
8? NewName // 也显示名称字段
9...
参见