FileSystemProxy.FindInFiles FileSystemProxy.FindInFiles FileSystemProxy.FindInFiles FileSystemProxy.FindInFiles Method

Definición

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos que contienen el texto especificado.Returns a read-only collection of strings representing the names of files containing the specified text.

Sobrecargas

FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption)

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos que contienen el texto especificado.Returns a read-only collection of strings representing the names of files containing the specified text.

FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[])

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos que contienen el texto especificado.Returns a read-only collection of strings representing the names of files containing the specified text.

FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption) FindInFiles(String, String, Boolean, SearchOption)

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos que contienen el texto especificado.Returns a read-only collection of strings representing the names of files containing the specified text.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);
public System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);
member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

Parámetros

directory
String String String String

Directorio en el que se va a buscar.The directory to be searched.

containsText
String String String String

Texto de búsqueda.The search text.

ignoreCase
Boolean Boolean Boolean Boolean

True si la búsqueda debe distinguir entre mayúsculas y minúsculas; de lo contrario, False.True if the search should be case-sensitive; otherwise False. El valor predeterminado es True.Default is True.

searchType
SearchOption SearchOption SearchOption SearchOption

Indica si se van a incluir las subcarpetas.Whether to include subfolders. El valor predeterminado es SearchOption.SearchTopLevelOnly.Default is SearchOption.SearchTopLevelOnly.

Devoluciones

Colección de solo lectura de los nombres de los archivos que contienen el texto especificado.Read-only collection of the names of files containing the specified text.

Excepciones

La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero, solo contiene un espacio en blanco, contiene caracteres no válidos o es una ruta de acceso de dispositivo (empieza por \.</code>).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \.</code>).

directory es Nothing o una cadena vacía.directory is Nothing or an empty string.

El directorio especificado no existe.The specified directory does not exist.

El directorio especificado apunta a un archivo existente.The specified directory points to an existing file.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

La ruta de acceso del directorio especificada contiene dos puntos (:) o tiene un formato no válido.The specified directory path contains a colon (:) or is in an invalid format.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene los permisos necesarios.The user lacks necessary permissions.

Ejemplos

En este ejemplo busca en el directorio C:\TestDir para todos los archivos que contiene la cadena "sample string" y muestra los resultados en ListBox1.This example searches the directory C:\TestDir for any files containing the string "sample string" and displays the results in 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 In list
    ListBox1.Items.Add(name)
Next

Para poder funcionar, el proyecto debe contener un ListBox denominado ListBox1.In order to work, the project must contain a ListBox named ListBox1.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.An empty collection is returned if no files matching the specified pattern are found.

En la tabla siguiente se muestra ejemplos de tareas que implican la My.Computer.FileSystem.FindInFiles método.The following table lists examples of tasks involving the My.Computer.FileSystem.FindInFiles method.

EnTo VeaSee
Buscar un directorio para archivos que contienen una cadena específicaSearch a directory for files containing a specific string Walkthrough: Manipulating Files and Directories in Visual Basic (Tutorial: Manipular archivos y directorios en Visual Basic)Walkthrough: Manipulating Files and Directories in Visual Basic

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

Consulte también:

FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[]) FindInFiles(String, String, Boolean, SearchOption, String[])

Devuelve una colección de cadenas de sólo lectura que representa los nombres de los archivos que contienen el texto especificado.Returns a read-only collection of strings representing the names of files containing the specified text.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);
member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)

Parámetros

directory
String String String String

Directorio en el que se va a buscar.The directory to be searched.

containsText
String String String String

Texto de búsqueda.The search text.

ignoreCase
Boolean Boolean Boolean Boolean

True si la búsqueda debe distinguir entre mayúsculas y minúsculas; de lo contrario, False.True if the search should be case-sensitive; otherwise False. El valor predeterminado es True.Default is True.

searchType
SearchOption SearchOption SearchOption SearchOption

Indica si se van a incluir las subcarpetas.Whether to include subfolders. El valor predeterminado es SearchOption.SearchTopLevelOnly.Default is SearchOption.SearchTopLevelOnly.

fileWildcards
String[]

Modelo con el que hay que coincidir.Pattern to be matched.

Devoluciones

Colección de solo lectura de los nombres de los archivos que contienen el texto especificado.Read-only collection of the names of files containing the specified text.

Excepciones

La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero, solo contiene un espacio en blanco, contiene caracteres no válidos o es una ruta de acceso de dispositivo (empieza por \.</code>).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \.</code>).

directory es Nothing o una cadena vacía.directory is Nothing or an empty string.

El directorio especificado no existe.The specified directory does not exist.

El directorio especificado apunta a un archivo existente.The specified directory points to an existing file.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

La ruta de acceso del directorio especificada contiene dos puntos (:) o tiene un formato no válido.The specified directory path contains a colon (:) or is in an invalid format.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene los permisos necesarios.The user lacks necessary permissions.

Ejemplos

En este ejemplo busca en el directorio C:\TestDir para todos los archivos que contiene la cadena "sample string" y muestra los resultados en ListBox1.This example searches the directory C:\TestDir for any files containing the string "sample string" and displays the results in 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 In list
    ListBox1.Items.Add(name)
Next

Para poder funcionar, el proyecto debe contener un ListBox denominado ListBox1.In order to work, the project must contain a ListBox named ListBox1.

Comentarios

Si no se encuentran archivos que coincidan con el patrón especificado, se devuelve una colección vacía.An empty collection is returned if no files matching the specified pattern are found.

En la tabla siguiente se muestra ejemplos de tareas que implican la My.Computer.FileSystem.FindInFiles método.The following table lists examples of tasks involving the My.Computer.FileSystem.FindInFiles method.

EnTo VeaSee
Buscar un directorio para archivos que contienen una cadena específicaSearch a directory for files containing a specific string Walkthrough: Manipulating Files and Directories in Visual Basic (Tutorial: Manipular archivos y directorios en Visual Basic)Walkthrough: Manipulating Files and Directories in Visual Basic

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

Consulte también:

Se aplica a