X# Runtime and VO SDK Reference
X# Runtime and SDK Reference
XSharp.RT
Functions 类
Functions 方法
_accept 方法
_ArrayToObjectArray 方法
_ArrayToUsualArray 方法
_Break 方法
_CallClipFunc 方法
_CreateInstance 方法
_GetMRandID 方法
_HasClipFunc 方法
_MClear 方法
_MRelease 方法
_MRestore 方法
_MSave 方法
_MxRelease 方法
_NoAlias 方法
_ObjectArrayToUsualArray 方法
_PrivateCount 方法
_PrivateEnum 方法
_PrivateFirst 方法
_PrivateNext 方法
_PublicCount 方法
_PublicEnum 方法
_PublicFirst 方法
_PublicNext 方法
_RegisterExit 方法
_Select 方法
_SelectString 方法
_SequenceError 方法
_SequenceRecover 方法
_Str 方法
_Str3 方法
_TextRestore 方法
_TextSave 方法
_UsualArrayToObjectArray 方法
_VoDbErrInfoPtr 方法
_wait 方法
AAdd 方法
Abs 方法
AbsFloat 方法
AClone 方法
ACloneShallow 方法
ACopy 方法
ACos 方法
ACot 方法
ADel 方法
ADim 方法
ADimPic 方法
ADir 方法
AEval 方法
AEvalA 方法
AEvalOld 方法
AFields 方法
AFill 方法
AIns 方法
ALen 方法
Alias 方法
Alias0 方法
Alias0Sym 方法
AllowCollectThread 方法
Ansi2OemBuff 方法
AReplicate 方法
Array 方法
ArrayBuild 方法
ArrayCreate 方法
ArrayDeProtect 方法
ArrayGet 方法
ArrayInit 方法
ArrayNew 方法
ArrayProtect 方法
ArrayPut 方法
ArrayStore 方法
ArraySwap 方法
AScan 方法
AScanBin 方法
AScanBinExact 方法
AScanExact 方法
ASend 方法
AsHexString 方法
ASin 方法
ASize 方法
ASort 方法
AsPadr 方法
AsString 方法
AsSymbol 方法
ATail 方法
ATan 方法
Atan2 方法
ATrueDel 方法
Between 方法
Bin2Date 方法
Bin2F 方法
Bin2Logic 方法
BLOBDirectExport 方法
BLOBDirectGet 方法
BLOBDirectImport 方法
BLOBDirectPut 方法
BLOBExport 方法
BLOBGet 方法
BLOBImport 方法
BLOBRootGet 方法
BLOBRootLock 方法
BLOBRootPut 方法
BLOBRootUnlock 方法
Bof 方法
CanBreak 方法
CDoW 方法
Ceil 方法
CheckInstanceOf 方法
ClassCount 方法
ClassList 方法
ClassName 方法
ClassTree 方法
ClassTreeClass 方法
cls 方法
CMonth 方法
Col 方法
Collect 方法
CollectCount 方法
CollectForced 方法
ConcatAtom 方法
ConcatAtom3 方法
ConcatAtom4 方法
ConcatAtom5 方法
ConDate 方法
Cos 方法
Cot 方法
CParamCount 方法
CreateInstance 方法
CSend 方法
CToD 方法
CToDAnsi 方法
Date 方法
Date2Bin 方法
Day 方法
DbApp 方法
DbAppDelim 方法
DbAppend 方法
DbAppSdf 方法
DbAutoLock 方法
DbAutoLockArea 方法
DbAutoUnLock 方法
DbAutoUnLockArea 方法
DbBlobInfo 方法
DbBuffRefresh 方法
DbClearFilter 方法
DbClearIndex 方法
DBClearOrderCondition 方法
DbClearRelation 方法
DbClearScope 方法
DbCloseAll 方法
DbCloseArea 方法
DbCommit 方法
DbCommitAll 方法
DbContinue 方法
DbCopy 方法
DbCopyDelim 方法
DbCopySDF 方法
DbCopyStruct 方法
DbCopyXStruct 方法
DbCreate 方法
DbCreateIndex 方法
DbCreateOrder 方法
DbDelete 方法
DbDeleteOrder 方法
DbDriver 方法
DbEval 方法
DBF 方法
DbFieldInfo 方法
DBFileCopy 方法
DbFilter 方法
DbGetSelect 方法
DbGoBottom 方法
DbGoto 方法
DbGoTop 方法
DbInfo 方法
DbJoin 方法
DbJoinAppend 方法
DbLocate 方法
DbMemoExt 方法
DbMemoField 方法
DbOrderInfo 方法
DbPack 方法
DbRecall 方法
DbRecordInfo 方法
DbReindex 方法
DbRelation 方法
DbRLock 方法
DbRLockList 方法
DbRSelect 方法
DbRUnLock 方法
DbScope 方法
DbSeek 方法
DbSelect 方法
DbSelectArea 方法
DbSetDriver 方法
DbSetFilter 方法
DbSetFound 方法
DbSetIndex 方法
DbSetOrder 方法
DbSetOrderCondition 方法
DbSetRelation 方法
DbSetScope 方法
DbSetSelect 方法
DbSkip 方法
DbSort 方法
DbStruct 方法
DbSymSelect 方法
DbTotal 方法
DbTrans 方法
DbUnLock 方法
DbUnLockAll 方法
DbUpdate 方法
DbUseArea 方法
DbZap 方法
DebOut 方法
Default 方法
Deleted 方法
Descend 方法
DescendA 方法
DirChange 方法
Directory 方法
DirMake 方法
DirRemove 方法
DiskChange 方法
DoError 方法
DoW 方法
DOY 方法
DToC 方法
DToR 方法
DToS 方法
Empty 方法
EmptyField 方法
EmptyPSZ 方法
EmptyRecord 方法
EmptyString 方法
EmptyUsual 方法
EnableArrayIndexCheck 方法
EnableLBOptimizations 方法
EnforceNumeric 方法
EnforceType 方法
Eof 方法
ErrorBlock 方法
ErrorExec 方法
ErrorSys 方法
Eval 方法
Evaluate 方法
ExecScript 方法
ExecScriptFast 方法
ExecScriptSlow 方法
Exp 方法
F2Bin 方法
Fact 方法
FCount 方法
FieldBlock 方法
FieldBlockSym 方法
FieldGet 方法
FieldGetAlias 方法
FieldGetArea 方法
FieldGetBytes 方法
FieldGetSelect 方法
FieldGetSym 方法
FieldName 方法
FieldPos 方法
FieldPosSym 方法
FieldPut 方法
FieldPutAlias 方法
FieldPutArea 方法
FieldPutBytes 方法
FieldPutSelect 方法
FieldPutSym 方法
FieldSym 方法
FieldWBlock 方法
FieldWBlockSym 方法
FindClass 方法
Float2Long 方法
FloatFormat 方法
Flock 方法
Floor 方法
Found 方法
FParamCount 方法
Frac 方法
FRead 方法
FRead3 方法
FRead4 方法
FReadLine 方法
FReadText3 方法
FSeek 方法
FWrite 方法
FWrite3 方法
FWriteLine 方法
FWriteText 方法
GetColor 方法
GetRTFullPath 方法
GetThreadCount 方法
GetTickCountLow 方法
Header 方法
InCollect 方法
IndexCount 方法
IndexExt 方法
IndexHPLock 方法
IndexKey 方法
IndexOrd 方法
InList 方法
InListExact 方法
Integer 方法
IsAccess 方法
IsArray 方法
IsAssign 方法
IsBinary 方法
IsByRef 方法
IsClass 方法
IsClassOf 方法
IsCodeBlock 方法
IsCurrency 方法
IsDate 方法
IsDateTime 方法
IsDecimal 方法
IsFloat 方法
IsFractional 方法
IsInstanceOf 方法
IsInstanceOfUsual 方法
IsInt64 方法
IsInteger 方法
IsLogic 方法
IsLong 方法
IsMethod 方法
IsMethodClass 方法
IsMethodUsual 方法
IsNil 方法
IsNumeric 方法
IsObject 方法
IsPtr 方法
IsString 方法
IsSymbol 方法
IVarGet 方法
IVarGetInfo 方法
IVarGetSelf 方法
IvarList 方法
IvarListClass 方法
IVarPut 方法
IVarPutInfo 方法
IVarPutSelf 方法
JCDOW 方法
JCMONTH 方法
JCYEAR 方法
LastRec 方法
Len 方法
LOG 方法
Log10 方法
LUpdate 方法
MAssign 方法
Max 方法
MaxAtom 方法
MCompile 方法
Mem2String 方法
MemAlloc 方法
MemAtSpecial 方法
MemByte 方法
MemCAlloc 方法
MemChr 方法
MemClear 方法
MemComp 方法
MemCopy 方法
MemCopyString 方法
MemDWord 方法
MemFree 方法
MemGrpAlloc 方法
MemGrpCAlloc 方法
MemGrpClose 方法
MemGrpEnum 方法
MemGrpOpen 方法
MemInt 方法
MemLen 方法
MemLong 方法
MemLower 方法
MemMove 方法
MemoTran 方法
MemRealloc 方法
MemSet 方法
MemShort 方法
MemTotal 方法
MemTrace 方法
MemUpper 方法
MemVarBlock 方法
MemVarBlockSym 方法
MemVarClear 方法
MemVarGet 方法
MemVarGetSym 方法
MemVarPut 方法
MemVarPutSym 方法
MemVarRelease 方法
MemVarTryGet 方法
MemWalk 方法
MemWord 方法
MethodList 方法
MethodListClass 方法
MExec 方法
Min 方法
MLCount 方法
MLcToPos 方法
MLPos 方法
Mod 方法
Month 方法
MParamCount 方法
MPosToLc 方法
NewIndexLock 方法
NewLocks 方法
NoMethod 方法
NTrim 方法
Object2Array 方法
Object2Float 方法
Oem2AnsiBuff 方法
OOPTree 方法
OOPTreeClass 方法
OrdBagExt 方法
OrdBagName 方法
OrdCondSet 方法
OrdCount 方法
OrdCreate 方法
OrdDescend 方法
OrdDestroy 方法
OrdFor 方法
OrdIsUnique 方法
OrdKey 方法
OrdKeyAdd 方法
OrdKeyCount 方法
OrdKeyDel 方法
OrdKeyGoto 方法
OrdKeyNo 方法
OrdKeyVal 方法
OrdList 方法
OrdListAdd 方法
OrdListClear 方法
OrdListRebuild 方法
OrdName 方法
OrdNumber 方法
OrdScope 方法
OrdSetFocus 方法
OrdSetRelation 方法
OrdSkipUnique 方法
Pad 方法
PadC 方法
PadL 方法
PadR 方法
PaletteRGB 方法
Pause 方法
PI 方法
Pow 方法
Psz2String 方法
Psz2Usual 方法
PszAlloc 方法
PszLen 方法
QOut 方法
QQOut 方法
Rand 方法
RddCount 方法
RddInfo 方法
RddList 方法
RddName 方法
RddSetDefault 方法
RddVersion 方法
RecCount 方法
RecNo 方法
RecSize 方法
RegisterAxit 方法
RLock 方法
Round 方法
Row 方法
RToD 方法
Select 方法
Send 方法
Set 方法
SetAlternate 方法
SetAltFile 方法
SetColor 方法
SetConsole 方法
SetFDateTime 方法
SetFloatDelta 方法
SetPos 方法
SetTextFile 方法
SetTextOutPut 方法
SEval 方法
SEvalA 方法
ShowArray 方法
ShowObject 方法
ShowPrivates 方法
ShowPublics 方法
Sin 方法
SplitPath 方法
SQrt 方法
SToD 方法
Str 方法
Str1 方法
Str2 方法
Str3 方法
StrEvaluate 方法
StrFloat 方法
String2Atom 方法
String2Symbol 方法
StringAlloc 方法
StrInt 方法
StrLong 方法
StrToFloat 方法
StrTran 方法
StrZero 方法
SubS 方法
SubStr 方法
Symbol2String 方法
SysAddAtom 方法
SysAddAtomUpperA 方法
SysCompAtom 方法
SysFindAtom 方法
SysGetAtomName 方法
Tan 方法
TimePsz 方法
TimePsz24 方法
Today 方法
Tone 方法
ToWord 方法
Transform 方法
TString 方法
Type 方法
Unformat 方法
UnRegisterAxit 方法
Used 方法
UsualType 方法
UsualVal 方法
Val 方法
ValType 方法
VarGet 方法
VarGetSym 方法
VarPut 方法
VarPutSym 方法
Version 方法
VoDbAlias 方法
VoDbAliasSym 方法
VoDbAppend 方法
VoDbBlobInfo 方法
VoDbBof 方法
VoDbBuffRefresh 方法
VoDbClearFilter 方法
VoDbClearLocate 方法
VoDbClearRelation 方法
VoDbClearScope 方法
VoDbCloseAll 方法
VoDbCloseArea 方法
VoDbCommit 方法
VoDbCommitAll 方法
VoDbContinue 方法
VoDbCreate 方法
VoDbDelete 方法
VoDbDeleted 方法
VoDbEof 方法
VoDbEval 方法
VoDbFieldGet 方法
VoDbFieldGetBytes 方法
VoDbFieldInfo 方法
VoDbFieldPut 方法
VoDbFieldPutBytes 方法
VoDbFileGet 方法
VoDbFilePut 方法
VoDbFilter 方法
VoDbFlock 方法
VoDbFound 方法
VoDbGetScope 方法
VoDbGetSelect 方法
VoDbGoBottom 方法
VoDbGoto 方法
VoDbGoTop 方法
VoDbInfo 方法
VoDbJoinAppend 方法
VoDbLastRec 方法
VoDbLocate 方法
VoDbMemoExt 方法
VoDbOrdBagExt 方法
VoDbOrdCondSet 方法
VoDbOrdCreate 方法
VoDbOrdDestroy 方法
VoDbOrderInfo 方法
VoDbOrdListAdd 方法
VoDbOrdListClear 方法
VoDbOrdListRebuild 方法
VoDbOrdSetFocus 方法
VoDbPack 方法
VoDbRddCount 方法
VoDbRddInfo 方法
VoDbRddList 方法
VoDbRddName 方法
VoDbRddSetDefault 方法
VoDbRecall 方法
VoDbRecno 方法
VoDbRecordGet 方法
VoDbRecordInfo 方法
VoDbRecordPut 方法
VoDbRelation 方法
VoDbRlock 方法
VoDbRSelect 方法
VoDbSeek 方法
VoDbSelect 方法
VoDbSetFilter 方法
VoDbSetFound 方法
VoDbSetLocate 方法
VoDbSetRelation 方法
VoDbSetScope 方法
VoDbSetSelect 方法
VoDbSkip 方法
VoDbSkipScope 方法
VoDbSort 方法
VoDbSymSelect 方法
VoDbTrans 方法
VoDbTransRec 方法
VoDbUnlock 方法
VoDbUnLockAll 方法
VoDbUseArea 方法
VoDbZap 方法
XSharpLoadLibrary 方法
Year 方法
点击或拖拽改变大小

Functions.DbFieldInfo 方法

X#
返回并可选择性地更改字段信息。

命名空间：  XSharp.RT
程序集：  XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION DbFieldInfo(
	kInfoType,
	nFieldPos,
	uNewSetting
) AS USUAL CLIPPER
查看代码

参数

kInfoType (Optional)
类型：__Usual
指定信息类型。
常量在下面的"常量"部分中描述。但请注意，并非所有 RDD 都支持所有常量。
有关支持的常量列表，请参见"备注"部分。
nFieldPos (Optional)
类型：__Usual
数据库文件结构中字段的位置或指向 BLOB 的数字指针。只有某些设计用于处理 BLOB 字段的 kInfoType 常量（在下面的"常量"部分中都有注明）允许使用指针指定字段；其他所有常量都要求通过字段位置指定字段。
uNewSetting (Optional)
类型：__Usual
如果指定，此参数用于更改设置的值。
数据类型（以及是否可以指定 uNewSetting）取决于 kInfoType 常量，并在下面的"常量"部分中有详细说明。

返回值

类型：__Usual
如果未指定 uNewSetting，DBFieldInfo() 返回当前设置。
如果指定了 uNewSetting，则返回先前的设置。
备注
DBFieldInfo() 检索字段（列）状态的信息。 默认情况下，此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定来使其在未选定的工作区上操作。
常量描述
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# 开发。
可用的字段信息由 RDD 定义。 在 DBF 工作区模型中，这仅限于存储在 DBF 文件结构中的信息 （即名称、长度、小数位数和数据类型）以及可以在运行时更改的字段别名。 为了支持其他数据库模型（如基于字典的数据库）的 RDD，这些数据库存储了 每个字段或列的更多信息，X# RDD API 已经得到了增强。
DBFieldInfo() 和 VODBFieldInfo() 函数旨在允许 第三方 RDD 开发人员定义额外的 kInfoType 值。
示例
以下示例使用 DBFieldInfo() 检索字段信息：
X#
复制
 1QOut(DBFieldInfo(DBS_NAME, 1))
 2// 等同于 FieldName(1)
 3FUNCTION DBOutStruct() AS ARRAY PASCAL
 4    LOCAL aStruct AS ARRAY
 5    LOCAL wFcount AS DWORD
 6    LOCAL i       AS DWORD
 7    aStruct := {}
 8    wFcount := FCount()
 9    FOR i := 1 UPTO wFcount
10        AAdd(aStruct, {FieldName(i), ;
11        DBFieldInfo(DBS_TYPE, i)  , ;
12        DBFieldInfo(DBS_LEN, i)   , ;
13        DBFieldInfo(DBS_DEC, i)}    )
14    NEXT
15    RETURN aStruct
下一个示例演示如何使用第三个参数为字段名分配别名：
X#
复制
1FUNCTION Start()
2    USE datebook
3    DBFieldInfo(DBS_ALIAS, FieldPos("Name"), "NewName")
4    ? Name            // 显示 name 字段
5    ? NewName            // 也显示 name 字段
参见