_Application.AdvancedSearch(String, Object, Object, Object) メソッド

定義

名前空間:

Microsoft.Office.Interop.Outlook

アセンブリ:

Microsoft.Office.Interop.Outlook.dll

指定された DAV Searching and Locating (DASL) 検索文字列に基づいて検索を実行します。

public Microsoft.Office.Interop.Outlook.Search AdvancedSearch (string Scope, object Filter, object SearchSubFolders, object Tag);

Public Function AdvancedSearch (Scope As String, Optional Filter As Object, Optional SearchSubFolders As Object, Optional Tag As Object) As Search

パラメーター

Scope

String

検索範囲を指定します。 たとえば、フォルダー パスなどを指定します。 フォルダー パスは単一引用符で囲むことをお勧めします。 単一引用符で囲まなかった場合、フォルダー パスに Unicode の文字が含まれていると、正しい結果を取得できないことがあります。 複数のフォルダー パスを指定するには、各フォルダー パスを単一引用符で囲み、コンマで区切ります。

Filter

Object

検索のパラメーターを定義する DASL 検索フィルターを指定します。

SearchSubFolders

Object

フォルダー内のサブフォルダーを検索するかどうかを指定します。

Tag

Object

検索の識別子として指定する名前です。

戻り値

Search

Search検索の結果を表す オブジェクト。

注釈

連続するコード行で AdvancedSearch メソッドを呼び出し、複数の検索を同時に実行することもできます。 ただし、多数の検索フォルダーをプログラム上で作成すると、検索処理が同時に多数行われるため、特にオンライン Exchange モードで検索を実行する場合などは、Outlook のパフォーマンスが影響を受けます。

AdvancedSearch メソッド、および Outlook オブジェクト モデルに含まれるその関連機能では、Outlook のユーザー インターフェイスに表示される検索フォルダーは作成されません。 ただし、返される Search オブジェクトの メソッドを使用 Save(String) して、Outlook ユーザー インターフェイスの [検索フォルダー] リストに表示される検索フォルダーを作成できます。

パラメーターを Scope 使用すると、同じストア内の 1 つ以上のフォルダーを指定できますが、複数のストアで複数のフォルダーを指定することはできません。 パラメーターに複数のフォルダーを Scope 指定するには、各フォルダー パスの間にコンマ文字を使用し、各フォルダー パスを単一引用符で囲みます。 受信トレイや送信済みアイテムなどの既定のフォルダーでは、完全なフォルダー パスではなく、単純なフォルダー名を使用できます。 たとえば、次のコード行は有効な Scope パラメーターを表します。

Dim Scope As String = "'Inbox', 'Sent Items'" string Scope = "'Inbox', 'Sent Items'";

Dim Scope1 As String = "'" & Application.Session.GetDefaultFolder( _
    Outlook.OlDefaultFolders.olFolderInbox).FolderPath & _
    "','" & Application.Session.GetDefaultFolder( _
    Outlook.OlDefaultFolders.olFolderSentMail).FolderPath

string Scope1 = "'" + Application.Session.GetDefaultFolder( 
    Outlook.OlDefaultFolders.olFolderInbox).FolderPath + 
    "','" + Application.Session.GetDefaultFolder( 
    Outlook.OlDefaultFolders.olFolderSentMail).FolderPath;

パラメーターには Filter 、任意の有効な DASL クエリを指定できます。 DASL クエリの詳細については、「 アイテムをフィルターにかける」、および「 名前空間でプロパティを参照する」を参照してください。 Advanced Search のパラメーターには JET クエリを使用できないことに Filter 注意してください。 パラメーターに指定されたフォルダーを含むストアで Scope インスタント検索が有効になっている場合は、インスタント検索キーワードを使用して検索のパフォーマンスを向上させることができます。 クイック検索が無効なときにクイック検索キーワードを使用すると、Outlook はエラーを返し、検索は失敗します。