Condividi tramite


FileSystemProxy.FindInFiles Metodo

Definizione

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenenti il testo specificato.

Overload

FindInFiles(String, String, Boolean, SearchOption)

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenenti il testo specificato.

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

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenenti il testo specificato.

FindInFiles(String, String, Boolean, SearchOption)

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenenti il testo specificato.

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)

Parametri

directory
String

Directory in cui eseguire la ricerca.

containsText
String

Testo di ricerca.

ignoreCase
Boolean

True se per la ricerca deve essere fatta distinzione tra maiuscole e minuscole; in caso contrario, False. Il valore predefinito è True.

searchType
SearchOption

Specifica se includere le sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly.

Restituisce

Raccolta di sola lettura dei nomi di file contenenti il testo specificato.

Eccezioni

Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \.</code>).

directory è Nothing o una stringa vuota.

La directory specificata non esiste.

La directory specificata punta a un file esistente.

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

Nel percorso della directory specificato sono presenti i due punti (:) oppure il formato non è valido.

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

L'utente non dispone delle autorizzazioni necessarie.

Esempio

In questo esempio viene eseguita una ricerca nella directory C:\TestDir per tutti i file contenenti la stringa "sample string" e vengono visualizzati i risultati 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

Per funzionare, il progetto deve contenere un ListBox oggetto denominato ListBox1.

Commenti

Se non vengono trovati file corrispondenti al criterio specificato, verrà restituita una raccolta vuota.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.FindInFiles metodo.

A Vedere
Search una directory per i file contenenti una stringa specifica Procedura dettagliata: Modifica di file e directory in Visual Basic

Vedi anche

Si applica a

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

Restituisce un insieme di stringhe in sola lettura che rappresenta i nomi dei file contenenti il testo specificato.

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)

Parametri

directory
String

Directory in cui eseguire la ricerca.

containsText
String

Testo di ricerca.

ignoreCase
Boolean

True se per la ricerca deve essere fatta distinzione tra maiuscole e minuscole; in caso contrario, False. Il valore predefinito è True.

searchType
SearchOption

Specifica se includere le sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly.

fileWildcards
String[]

Criterio da soddisfare.

Restituisce

Raccolta di sola lettura dei nomi di file contenenti il testo specificato.

Eccezioni

Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero; contiene solo spazi vuoti; contiene caratteri non validi; o è un percorso del dispositivo (inizia con \.</code>).

directory è Nothing o una stringa vuota.

La directory specificata non esiste.

La directory specificata punta a un file esistente.

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

Nel percorso della directory specificato sono presenti i due punti (:) oppure il formato non è valido.

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

L'utente non dispone delle autorizzazioni necessarie.

Esempio

In questo esempio viene eseguita una ricerca nella directory C:\TestDir per tutti i file contenenti la stringa "sample string" e vengono visualizzati i risultati 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

Per funzionare, il progetto deve contenere un ListBox oggetto denominato ListBox1.

Commenti

Se non vengono trovati file corrispondenti al criterio specificato, verrà restituita una raccolta vuota.

Nella tabella seguente sono elencati esempi di attività che coinvolgono il My.Computer.FileSystem.FindInFiles metodo.

A Vedere
Search una directory per i file contenenti una stringa specifica Procedura dettagliata: Modifica di file e directory in Visual Basic

Vedi anche

Si applica a