次の方法で共有

_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 の Filter パラメーターには JET クエリを使用できないことに注意してください。 Scope パラメーターで指定されたフォルダーを含むストアでインスタント検索が有効になっている場合は、インスタント検索キーワードを使用して検索のパフォーマンスを向上させることができます。 クイック検索が無効なときにクイック検索キーワードを使用すると、Outlook はエラーを返し、検索は失敗します。

適用対象