_Application.AdvancedSearch(String, Object, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Outlook

Ensamblado:

Microsoft.Office.Interop.Outlook.dll

Realiza una búsqueda basada en una cadena de búsqueda especificada de 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

Parámetros

Scope

String

Ámbito de la búsqueda. Por ejemplo, la ruta de acceso de una carpeta. Se recomienda escribir la ruta de acceso de la carpeta entre comillas sencillas. En caso contrario, es posible que la búsqueda no devuelva resultados correctos si la ruta de acceso de la carpeta contiene caracteres especiales, incluidos los caracteres Unicode. Para especificar varias rutas de acceso de carpeta, escriba cada una entre comillas sencillas y separe con una coma las que estén escritas entre comillas sencillas.

Filter

Object

Filtro de búsqueda DASL que define los parámetros de la búsqueda.

SearchSubFolders

Object

Determina si la búsqueda incluirá cualquier subcarpeta de la carpeta.

Tag

Object

Nombre especificado como identificador de la búsqueda.

Devoluciones

Search

Objeto Search que representa los resultados de la búsqueda.

Comentarios

Puede ejecutar varias búsquedas simultáneamente llamando el método AdvancedSearch en líneas sucesivas de código. Sin embargo, debe tener en cuenta que mediante programación creando un gran número de carpetas de búsqueda puede producir actividad importante búsqueda simultáneas que podría afectar al rendimiento de Outlook, especialmente si Outlook lleva a cabo la búsqueda en el modo de intercambio en línea.

El método AdvancedSearch y las características relacionadas en el modelo de objetos de Outlook no crean una carpeta de búsqueda que aparecerá en la interfaz de usuario de Outlook. Sin embargo, puede usar el Save(String) método del objeto Search que se devuelve para crear una carpeta de búsqueda que aparecerá en la lista Carpetas de búsqueda de la interfaz de usuario de Outlook.

Con el Scope parámetro , puede especificar una o varias carpetas en el mismo almacén, pero es posible que no especifique varias carpetas en varios almacenes. Para especificar varias carpetas para el Scope parámetro, use un carácter de coma entre cada ruta de acceso de carpeta y incluya cada ruta de acceso de carpeta entre comillas simples. Para carpetas predeterminadas, como la Bandeja de entrada o elementos enviados, puede utilizar el nombre de carpeta simple en lugar de la ruta de acceso completa a la carpeta. Por ejemplo, las siguientes líneas de código representan parámetros válidos 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;

El Filter parámetro puede ser cualquier consulta DASL válida. Para obtener información adicional sobre las consultas DASL, vea Filtrado de elementos y Referencia de propiedades por espacio de nombres. Tenga en cuenta que no puede usar una consulta JET para el Filter parámetro de Búsqueda avanzada. Si La búsqueda instantánea está habilitada en un almacén que contiene una carpeta especificada en el Scope parámetro , puede usar palabras clave De búsqueda instantánea para mejorar el rendimiento de la búsqueda. Si utiliza palabras clave de búsqueda instantánea y búsqueda instantánea no está habilitada, Outlook devolverá que un error y la búsqueda se producirá un error.