尋找並傳回滿足指定 篩選條件的 Microsoft Outlook 項目物件。
語法
運算式。尋找 (篩選)
運算式 傳回 Items 物件的運算式。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| Filter | 必要 | 字串 | 會指定準則的字串,且傳回的物件必須滿足其準則。 |
傳回值
如果呼叫成功,代表 Outlook 項目的 物件 值;如果失敗,會在 Visual Basic) 中返回 Null (或 Nothing 。
註解
若要在 [項目 ] 集合中使用內容索引搜尋,請使用 Restrict 方法。 FindRow 會在 Filter 包含內容索引關鍵字時傳回錯誤。 如需內容索引關鍵字的詳細資訊,請參閱使用查詢關鍵字篩選項目。
此方法會在 篩選 器中傳回具有下列屬性的錯誤:
| Body | LastFirstNoSpaceCompany |
|---|---|
| Children | LastFirstSpaceOnlyCompany |
| Class | LastFirstNoSpaceAndSuffix |
| Companies | MemberCount |
| CompanyLastFirstNoSpace | NetMeetingAlias |
| CompanyLastFirstSpaceOnly | NetMeetingAutoStart |
| ContactNames | NetMeetingOrganizerAlias |
| 連絡人 | NetMeetingServer |
| ConversationIndex | NetMeetingType |
| DLName | RecurrenceState |
| Email1EntryID | ReplyRecipients |
| Email2EntryID | ReceivedByEntryID |
| Email3EntryID | ReceivedOnBehalfOfEntryID |
| EntryID | ResponseState |
| HTMLBody | Saved |
| IsOnlineMeeting | Sent |
| LastFirstAndSuffix | Submitted |
| LastFirstNoSpace | VotingOptions |
| AutoResolvedWinner | DownloadState |
| BodyFormat | IsConflict |
| InternetCodePage | MeetingWorkspaceURL |
| Permission |
建立 Find 及 Restrict 方法的篩選條件
篩選條件的語法會根據您所篩選的欄位類型而有所不同。
字串 (適用於文字欄位)
篩選文字欄位時,您可以使用一對單引號 (') 或一對雙引號 (“) 來分隔篩選中的值。 例如,當欄位類型為 [字串 ] 時,下列所有行都會正常運作:
sFilter = "[CompanyName] = 'Microsoft'"
sFilter = "[CompanyName] = ""Microsoft"""
sFilter = "[CompanyName] = " & Chr(34) & "Microsoft" & Chr(34)
在 Jet 或 DASL 查詢中指定篩選時,如果您使用一對單引號來分隔屬於篩選的字串,而且字串包含另一個單引號或簡縮號 (Apostrophe),請在該單引號或簡縮號前面加上一個單引號做為逸出字元。 如果您使用一對雙引號來分隔字串,也請套用相同的方法。 如果字串包含雙引號,請在雙引號前面加上一個雙引號來做為逸出字元。
例如,在 DASL 篩選字串中,篩選 Subject 屬性 can't等於文字,整個篩選字串會以雙引號分隔,內嵌字串 can't 會以一對單引號分隔。 此篩選字串中需要逸出三個字元:屬性參照 http://schemas.microsoft.com/mapi/proptag/0x0037001f的開頭雙引號和結尾雙引號 ,以及文字 can't值條件中的單引號 。 您可以套用適當的逸出字元,如下表示篩選字串:
filter = "@SQL=""http://schemas.microsoft.com/mapi/proptag/0x0037001f"" = 'can''t'"
或者,您可以使用函數來 chr(34) 表示 ASCII 字元值為 34) 的雙引號 (,用來做為逸出字元。 藉由使用 chr(34) 取代雙引號逸出字元,就能如下表示上列範例:
filter = "@SQL= " & Chr(34) & "http://schemas.microsoft.com/mapi/proptag/0x0037001f" _& Chr(34) & " = " & "'can''t'"
使用 ci_startswith 或 ci_phrasematch 運算子的 DASL 查詢,也需要逸出單引號及雙引號字元。 例如,下列查詢會在郵件主旨中執行 can't 的片語比對查詢:
filter = "@SQL=" & Chr(34) & "http://schemas.microsoft.com/mapi/proptag/0x0037001E" _& Chr(34) & " ci_phrasematch " & "'can''t'"
另一個範例是 DASL 篩選字串,可篩選 Subject 屬性是否等於文字 the right stuff,其中文字 stuff 會以雙引號括住。 在這種情況下,括住的雙引號必須逸出,如下所示:
filter = "@SQL=""http://schemas.microsoft.com/mapi/proptag/0x0037001f"" = 'the right ""stuff""'"
一組不同的逸出規則適用於含有空格、單引號、雙引號或百分比字元之具名屬性的屬性參照。 如需詳細資訊,請參閱依命名空間參照屬性。
Date
雖然日期和時間通常會以 日期 格式儲存,但 尋找 和 限制 方法要求將日期和時間轉換成字串表示法。 請使用 Format 函數,確保日期格式化為 Outlook 所預期的格式。 下列範例會建立一個篩選條件,尋找在 1999 年 1 月 15 日下午 3:30 分之後修改的所有連絡人。
sFilter = "[LastModificationTime] > '" & Format("1/15/99 3:30pm", "ddddd h:nn AMPM") & "'"
布林值運算元
布林值運算子、TRUE/ 、FALSE、YES/NO、ON/OFF 等不應該轉換成字串。 例如,若要判斷連絡人的日誌功能是否啟用,您可以使用這個篩選:
sFilter = "[Journal] = True"
注意事項
如果您對 布林 值欄位使用引號做為分隔符號,則空白字串會尋找欄位為 False 的項目,而所有非空字串會尋找欄位為 True 的項目。
關鍵字 (或類別)
[類別] 欄位屬於類型的關鍵字,設計用來存放多個值。 以程式設計方式存取 [類別] 欄位時,它的行為和 [文字] 欄位相同,而且字串必須完全相符。 文字字串中的值是由逗號及空格分隔。 這通常表示如果關鍵字欄位中包含多個值,您便無法使用 Find 及 Restrict 方法。 例如,如果有一個連絡人屬於 Business 類別,而且有另一個連絡人同時屬於 Business 及 Social 類別,那麼您無法直接使用 Find 及 Restrict 方法來擷取 Business 類別中的所有項目。 不過,您可以逐一查看資料夾中的所有連絡人,並且使用 Instr 函數來測試整個關鍵字欄位中是否包含 "Business" 字串。
注意事項
可能的例外狀況是,您將 [類別 ] 欄位限制為兩個或較少的值數目。 然後,您可以使用 Find 和 Restrict 方法搭配 OR 邏輯運算子來擷取所有商務連絡人。 例如,在虛擬程式碼) 中 (:「Business」或「Business, Personal」或「Personal, Business」。類別字串不區分大小寫。
整數
搜尋 [整數] 欄位時,您可以使用也可以不使用引號做為分隔字元。 下列篩選會尋找使用 Outlook 2000 建立的連絡人:
sFilter = "[OutlookInternalVersion] = 92711"
sFilter = "[OutlookInternalVersion] = '92711'"
使用變數做為篩選條件的一部分
如同 Restrict 方法範例的說明,您可以使用變數的值做為篩選條件的一部分。 下列 Microsoft Visual Basic Scripting Edition (VBScript) 程式碼範例將說明使用變數做為篩選條件的一部分的語法。
sFullName = "Dan Wilson"
此方法使用 Chr (34) 來分隔值:
sFilter = "[FullName] = " & Chr(34) & sFullName & Chr(34)
此方法使用雙引號來分隔值:
sFilter = "[FullName] = """ & sFullName & """"
使用邏輯運算元做為篩選條件的一部分
允許使用的邏輯運算元包括 AND、OR 及 NOT。 下列為 Restrict 方法子句的變化,如此您就可以指定多個準則。
OR:下列程式碼會傳回屬於 Business 或 Personal 類別的所有連絡人項目。
sFilter = "[Categories] = 'Personal' Or [Categories] = 'Business'"
AND:下列程式碼會擷取所有在 Microsoft 工作的個人連絡人。
sFilter = "[Categories] = 'Personal' And [CompanyName] = 'Microsoft'"
NOT:下列程式碼會擷取所有不在 Microsoft 工作的個人連絡人。
sFilter = "[Categories] = 'Personal' And Not([CompanyName] = 'Microsoft')"
其他附註
如果您嘗試搭配使用者自訂欄位使用 Find 或 Restrict 方法,那麼必須在資料夾中定義該欄位,否則會發生錯誤。 無法執行「包含」作業。 例如,您無法使用 Find 或 Restrict 在 [主旨] 欄位搜尋包含特定文字的項目。 但是,您可以使用 AdvancedSearch 方法,或是逐一查詢資料夾中的所有項目,並且使用 InStr 函數在任一欄位中執行搜尋。 使用 Restrict 方法搜尋以特定字元範圍開頭的項目。 例如,使用下列篩選條件,搜尋姓氏開始字元為字母 M 的所有連絡人:
sFilter = "[LastName] > 'LZZZ' And [LastName] < 'N'"
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。