FileSystemProxy.FindInFiles Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí kolekci řetězců jen pro čtení představující názvy souborů obsahujících zadaný text.
Přetížení
FindInFiles(String, String, Boolean, SearchOption) |
Vrátí kolekci řetězců jen pro čtení představující názvy souborů obsahujících zadaný text. |
FindInFiles(String, String, Boolean, SearchOption, String[]) |
Vrátí kolekci řetězců jen pro čtení představující názvy souborů obsahujících zadaný text. |
FindInFiles(String, String, Boolean, SearchOption)
Vrátí kolekci řetězců jen pro čtení představující názvy souborů obsahujících zadaný 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)
Parametry
- directory
- String
Adresář, který se má prohledávat.
- containsText
- String
Hledaný text
- ignoreCase
- Boolean
True
pokud se při hledání rozlišují malá a velká písmena; jinak False
. Výchozí je True
.
- searchType
- SearchOption
Jestli se mají zahrnout podsložky. Výchozí je SearchOption.SearchTopLevelOnly
.
Návraty
Kolekce názvů souborů obsahujících zadaný text jen pro čtení.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \.</code>).
directory
je Nothing
nebo prázdný řetězec.
Zadaný adresář neexistuje.
Zadaný adresář odkazuje na existující soubor.
Cesta přesahuje systémem definovanou maximální délku.
Zadaná cesta k adresáři obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Uživatel nemá potřebná oprávnění.
Příklady
Tento příklad vyhledá v adresáři C:\TestDir
všechny soubory obsahující řetězec "sample string"
a zobrazí výsledky v 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
Aby projekt fungoval, musí obsahovat pojmenovaný ListBox
.ListBox1
Poznámky
Pokud nejsou nalezeny žádné soubory odpovídající zadanému vzoru, vrátí se prázdná kolekce.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.FindInFiles
.
Záměr
Seznamte se s
Search adresáře pro soubory obsahující konkrétní řetězec
Návod: Práce se soubory a adresáři v jazyce Visual Basic
Viz také
- SearchOption
- ReadOnlyCollection<T>
- Objekty (Visual Basic)
- Návod: Práce se soubory a adresáři v jazyce Visual Basic
Platí pro
FindInFiles(String, String, Boolean, SearchOption, String[])
Vrátí kolekci řetězců jen pro čtení představující názvy souborů obsahujících zadaný 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)
Parametry
-
directory
-
String
Adresář, který se má prohledávat.
-
containsText
-
String
Hledaný text
-
ignoreCase
-
Boolean
True
pokud se při hledání rozlišují malá a velká písmena; jinak False
. Výchozí je True
.
-
searchType
-
SearchOption
Jestli se mají zahrnout podsložky. Výchozí je SearchOption.SearchTopLevelOnly
.
-
fileWildcards
-
String[]
Vzor, který se má shodovat.
Návraty
Kolekce názvů souborů obsahujících zadaný text jen pro čtení.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \.</code>).
directory
je Nothing
nebo prázdný řetězec.
Zadaný adresář neexistuje.
Zadaný adresář odkazuje na existující soubor.
Cesta přesahuje systémem definovanou maximální délku.
Zadaná cesta k adresáři obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Uživatel nemá potřebná oprávnění.
Příklady
Tento příklad vyhledá v adresáři C:\TestDir
všechny soubory obsahující řetězec "sample string"
a zobrazí výsledky v 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
Aby projekt fungoval, musí obsahovat pojmenovaný ListBox
.ListBox1
Poznámky
Pokud nejsou nalezeny žádné soubory odpovídající zadanému vzoru, vrátí se prázdná kolekce.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.FindInFiles
.
Záměr
Seznamte se s
Search adresáře pro soubory obsahující konkrétní řetězec
Návod: Práce se soubory a adresáři v jazyce Visual Basic
Viz také
- SearchOption
- ReadOnlyCollection<T>
- Objekty (Visual Basic)
- Návod: Práce se soubory a adresáři v jazyce Visual Basic
Platí pro