Functions.Seek 方法 | |
-- todo --
在索引表中搜索第一个索引键与指定表达式匹配的记录。
执行 Seek( ) 相当于依次执行 Seek 和 FOUND( )。
X# 不支持对二进制索引进行搜索操作。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION Seek(
eExpression,
uArea,
uIndex
) AS LOGIC CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static bool Seek(
__Usual eExpression = default,
__Usual uArea = default,
__Usual uIndex = default
)
查看代码参数
- eExpression (Optional)
- 类型:__Usual
指定要搜索的索引键表达式。
- uArea (Optional)
- 类型:__Usual
指定要搜索索引键的工作区号。
或
指定要搜索的表别名。如果省略 uArea,则搜索当前选定工作区中的表。
- uIndex (Optional)
- 类型:__Usual
指定用于搜索索引键的索引文件或标记的编号。
nIndexNumber 指的是在 Use 或 Set Index 中列出的索引文件。打开的 .idx 文件首先按照它们在 Use 或 Set Index 中出现的顺序编号。
然后,结构化 .cdx 文件(如果存在)中的标记按照它们创建的顺序编号。最后,任何打开的独立 .cdx 文件中的标记按照它们创建的顺序编号。
有关索引编号的更多信息,请参见 Set Order 命令。
返回值
类型:
Boolean
逻辑值。如果找到匹配项并且记录指针移动到匹配记录,Seek( ) 返回 True (.T.)。
否则,如果未找到匹配项,Seek( ) 返回 False (.F.),并且如果 Set NEAR 为 OFF,记录指针移动到文件末尾,
如果 Set NEAR 为 ON,则移动到最接近的匹配记录。
备注
您可以在设置了索引顺序的表上使用 Seek( ),或者如果表上未设置索引顺序,可以使用第三个参数 nIndexNumber、cIDXIndexFileName
或 cTagName 设置控制索引。除非 Set EXACT 设置为 OFF,否则匹配必须精确。
如果省略 nIndexNumber、IDXIndexFileName 和 cTagName 参数,
Seek( ) 将使用主控索引或索引标记来搜索索引键。
如果 Seek( ) 使用非活动索引,则忽略 Set KEY 设置。
示例 1Close Databases
2Open Database (HOME(2) + 'Data\testdata')
3Use customer Order cust_id
4? Seek('CHOPS')
参见