My.Computer.FileSystem.FindInFiles (Método)

Actualización: noviembre 2007

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos y contiene el texto especificado.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.FindInFiles(directory ,containsText ,ignoreCase ,searchType)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.FindInFiles(directory ,containsText ,ignoreCase ,searchType ,fileWildcards)
' Declaration
Public Function FindInFiles( _
   ByVal directory As String, _
   ByVal containsText As String, _
   ByVal ignoreCase As Boolean, _
   ByVal searchType As SearchOption _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function FindInFiles( _
   ByVal directory As String, _
   ByVal containsText As String, _
   ByVal ignoreCase As Boolean, _
   ByVal searchType As SearchOption, _
   ByVal fileWildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parámetros

• Directory
  String. Directorio en el que se va a buscar. Obligatorio.

• containsText
  String. Texto de la búsqueda. Obligatorio.

• ignoreCase
  Boolean. Especifica si la búsqueda debe distinguir entre mayúsculas y minúsculas. El valor predeterminado es True. Obligatorio.

• searchType
  SearchOption (Enumeración). Si se han de incluir las subcarpetas. El valor predeterminado es SearchOption.SearchTopLevelOnly. Obligatorio.

• fileWildcards
  Matriz de tipo String. Modelo con el que debe coincidir. Obligatorio.

Valor devuelto

Colección de sólo lectura de tipoString.

Excepciones

Las condiciones siguientes pueden producir una excepción:

• La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).

• La ruta de acceso no es válida porque es Nothing (ArgumentNullException).

• directory no existe (DirectoryNotFoundException).

• directory señala a un archivo existente (IOException).

• La ruta supera la longitud máxima definida por el sistema (PathTooLongException).

• Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).

• El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

• El usuario no tiene los permisos necesarios (UnauthorizedAccessException).

Comentarios

Se devuelve una colección vacía si no se encuentra ningún archivo que coincida con el modelo especificado.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.FindInFiles.

Ejemplo

Este ejemplo busca en el directorio C:\TestDir cualquier archivo que contiene la cadena "sample string" y muestra los resultados en un control ListBox1.

Dim list As System.Collections.ObjectModel.ReadOnlyCollection _
(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", _
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name As String In list
    ListBox1.Items.Add(name)
Next

Para que funcione, el proyecto debe contener un control ListBox denominado ListBox1.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

El permiso siguiente puede ser necesario:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Tutorial: Manipular archivos y directorios en Visual Basic

Referencia

My.Computer.FileSystem (Objeto)

SearchOption (Enumeración)

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.FindInFiles