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.DbLocate 方法

X#
搜索匹配指定条件和范围的第一条记录。

命名空间：  XSharp.RT
程序集：  XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA
语法
复制
 FUNCTION DbLocate(
	cbForCondition,
	cbWhileCondition,
	nNext,
	nRecord,
	lRest,
	lNoOpt
) AS LOGIC CLIPPER
查看代码

参数

cbForCondition (Optional)
类型：__Usual
定义范围内每条记录必须满足的条件的代码块，以便进行处理。
cbWhileCondition (Optional)
类型：__Usual
定义每条记录必须满足的另一个条件的代码块，以便进行处理。 一旦遇到导致条件失败的记录，操作就会终止。
如果未指定范围，cbWhileCondition 会将默认范围更改为 lRest。
您可以使用这三个互斥参数之一来定义范围。
默认是所有记录。
nNext (Optional)
类型：__Usual
要处理的记录数，从 nRecord 开始。 指定 0 以忽略此参数。
nRecord (Optional)
类型：__Usual
要处理的单个记录号。指定 0 以忽略此参数。
lRest (Optional)
类型：__Usual
TRUE 仅处理从 nStart 到文件末尾的记录。 FALSE 处理所有记录。
lNoOpt (Optional)
类型：__Usual
禁用（Rushmore）优化（尚不支持）。

返回值

类型：Boolean
如果成功则返回TRUE；否则返回FALSE。
备注
提示 提示：
nNext、nRecord 和 lRest 参数是互斥的。您不应同时传递这三个参数。 如果您传递 cbWhile 参数，那么它也会控制范围行为。
默认情况下，此函数在当前选定的工作区上操作。
可以通过在别名表达式中指定来使其在未选定的工作区上操作。 DBLocate()是LOCATE命令的函数形式。 DBLocate()从范围的起始记录开始搜索。
当找到匹配项或达到范围末尾时终止。
如果成功，匹配的记录成为当前记录，Found()返回TRUE。 如果不成功，Found()返回FALSE，记录指针的位置取决于范围。 每个工作区可以有自己的定位条件。 该条件保持活动状态，直到在该工作区执行另一个定位条件或应用程序终止。 DBLocate()与DBContinue()配合使用。一旦发出DBLocate()，您可以使用DBContinue()从当前记录指针位置恢复搜索。 然而，有一些例外。范围和cbWhileCondition仅适用于初始DBLocate()函数，对任何后续DBContinue()函数不起作用。
要继续带有范围或cbWhileCondition的待定定位条件，请使用DBSkip()；然后使用lRest和cbWhileCondition参数的DBLocate()，而不是DBContinue()。
示例
此示例按顺序搜索字符串：
X#
复制
1PROCEDURE Start()
2    DBUseArea(TRUE,, "sales")
3        DBLocate({||"Widget" == Sales->Name},,,-1)
4    IF Found()
5        QOut("我有一个小部件。")
6    ELSE
7        QOut("未找到。")
8    ENDIF
9    RETURN
参见