搜尋 Recordset 符合指定準則的數據列。 或者,可以指定搜尋方向、起始數據列和起始數據列的位移。 如果符合準則,則會在找到的記錄上設定目前的數據列位置;否則,位置會設定為 Recordset 的結尾(或開始)。
語法
Find (Criteria, SkipRows, SearchDirection, Start)
參數
準則
String 值,包含語句,指定要在搜尋中使用的數據行名稱、比較運算符和值。
SkipRows
選擇性。
Long 值,其預設值為零,指定從目前數據列或開始搜尋開始書籤的數據列位移。 根據預設,搜尋會從目前的數據列開始。
SearchDirection
選擇性。
SearchDirectionEnum 值,指定搜尋應該從目前數據列開始,還是搜尋方向的下一個可用數據列。 如果值為 adSearchForward,則不成功的搜尋會在 Recordset 結尾停止。 如果值為 adSearchBackward,則不成功的搜尋會在 Recordset 的開頭停止。
開始
選擇性。
Variant 書籤,可作為搜尋的起始位置。
備註
準則中只能指定單一數據行名稱。 此方法不支援多重數據行搜尋。
Criteria 中的比較運算符可以是 “>” (大於)、“<” (小於)、“=” (equal)、“>=” (大於或等於)、“=” (小於或等於<>)、“<” (不相等),或 “like” (模式比對)。
Criteria 中的值可以是字串、浮點數或日期。 字串值會以單引號或 “#” (數字符號) 標記分隔(例如“state = 'WA'” 或 “state = #WA#” )。 日期值會以 “#” (數字符號) 標記分隔(例如,“start_date > #7/22/97#”。 這些值可以包含小時、分和秒來指出時間戳,但不應包含毫秒或錯誤。
如果比較運算子為 「like」,字串值可能會包含星號 ^ ,以尋找任何字元或子字串的一或多個出現次數。 例如,“state like 'M*'” 匹配緬因州和馬薩諸塞州。 您也可以使用前置和尾端星號來尋找值中包含的子字串。 例如,「state like '*as*'」會匹配阿拉斯加、阿肯色州和麻薩諸塞州。
星號只能用在準則字串的結尾,或在準則字串的開頭和結尾使用,如上所示。 您無法使用星號作為前置通配符(『*str』),或作為內嵌通配符('s*r')。 這會導致錯誤。
備註
如果在呼叫 Find 之前未設定目前的數據列位置,就會發生錯誤。 任何設定數據列位置的方法,例如 MoveFirst,都應該在呼叫 Find 之前呼叫。
備註
如果您在記錄集上呼叫 Find 方法,而且記錄集中的目前位置位於檔案的最後一筆記錄或結尾處(EOF),則不會找到任何專案。 您必須呼叫 MoveFirst 方法,將目前的位置/游標設定為記錄集的開頭。