Outlook) (Items.Find 方法

尋找並傳回滿足指定 篩選條件的 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'"

另請參閱

Items 物件

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。