Metodo My.Computer.FileSystem.FindInFiles

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

' 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)

Parametri

Directory
String. Directory da esaminare. Obbligatorio.
containsText
String. Testo da cercare. Obbligatorio.
ignoreCase
Boolean. Indica se per la ricerca deve essere applicata la distinzione tra maiuscole e minuscole. Il valore predefinito è True. Obbligatorio.
searchType
Enumerazione SearchOption. Indica se includere o meno sottocartelle. Il valore predefinito è SearchOption.SearchTopLevelOnly. Obbligatorio.
fileWildcards
Matrice di tipo String. Criterio di ricerca da soddisfare. Obbligatorio.

Valore restituito

Insieme in sola lettura di tipo String.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\ (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
directory non esiste DirectoryNotFoundException).
directory punta a un file esistente (IOException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).
L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).

Note

Viene restituito un insieme vuoto se non vengono trovati file corrispondenti al modello specificato.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.FindInFiles.

Per	Vedere
Cercare in una directory i file contenenti una stringa specificata	Procedura dettagliata: modifica di file e directory in Visual Basic

Esempio

In questo esempio viene esaminata la directory C:\TestDir per cercare i file che contengono la stringa "sample string" e i risultati vengono visualizzati 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 As String In list
    ListBox1.Items.Add(name)
Next

L'operazione potrà essere eseguita soltanto se il progetto contiene un oggetto ListBox denominato ListBox1.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce accesso a FileSystem)

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	Sì
Servizio Windows	Sì
Sito Web	Sì