Directory.EnumerateFileSystemEntries Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca wyliczaną kolekcję wpisów systemu plików spełniających określone kryteria.
Przeciążenia
| Nazwa | Opis |
|---|---|
| EnumerateFileSystemEntries(String) |
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów w określonej ścieżce. |
| EnumerateFileSystemEntries(String, String) |
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów, które pasują do wzorca wyszukiwania w określonej ścieżce. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów, które są zgodne ze wzorcem wyszukiwania i opcjami wyliczania w określonej ścieżce. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów pasujących do wzorca wyszukiwania w określonej ścieżce i opcjonalnie wyszukuje podkatalogi. |
EnumerateFileSystemEntries(String)
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów w określonej ścieżce.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);static member EnumerateFileSystemEntries : string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)Parametry
- path
- String
Względna lub bezwzględna ścieżka do katalogu do wyszukania. Ten ciąg nie uwzględnia wielkości liter.
Zwraca
Wyliczalna kolekcja wpisów systemu plików w katalogu określonym przez path.
Wyjątki
.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .
Parametr path ma wartość null.
path jest nieprawidłowy, na przykład odwoływania się do niezamapowanego dysku.
path to nazwa pliku.
Określona ścieżka, nazwa pliku lub połączone przekraczają maksymalną długość zdefiniowaną przez system.
Obiekt wywołujący nie ma wymaganych uprawnień.
Obiekt wywołujący nie ma wymaganych uprawnień.
Uwagi
Możesz określić informacje o ścieżce względnej za pomocą parametru path . Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego GetCurrentDirectory , który można określić przy użyciu metody .
Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: jeśli używasz EnumerateFileSystemEntriesmetody , możesz rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz GetFileSystemEntriesmetody , musisz poczekać na zwrócenie całej tablicy wpisów, zanim będzie można uzyskać dostęp do tablicy. W związku z tym podczas pracy z wieloma plikami i katalogami EnumerateFileSystemEntries może być wydajniejszy.
Zwrócona kolekcja nie jest buforowana; każde wywołanie GetEnumerator obiektu w kolekcji spowoduje uruchomienie nowego wyliczenia.
Dotyczy
EnumerateFileSystemEntries(String, String)
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów, które pasują do wzorca wyszukiwania w określonej ścieżce.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);static member EnumerateFileSystemEntries : string * string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)Parametry
- path
- String
Względna lub bezwzględna ścieżka do katalogu do wyszukania. Ten ciąg nie uwzględnia wielkości liter.
- searchPattern
- String
Ciąg wyszukiwania zgodny z nazwami wpisów systemu plików w pliku .path Ten parametr może zawierać kombinację prawidłowych znaków literału i symboli wieloznacznych (* i ?), ale nie obsługuje wyrażeń regularnych.
Zwraca
Wyliczalna kolekcja wpisów systemu plików w katalogu określonym przez path element i pasujących do określonego wzorca wyszukiwania.
Wyjątki
.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .
— lub —
searchPattern nie zawiera prawidłowego wzorca.
Parametr path ma wartość null.
— lub —
Parametr searchPattern ma wartość null.
path jest nieprawidłowy, na przykład odwoływania się do niezamapowanego dysku.
path to nazwa pliku.
Określona ścieżka, nazwa pliku lub połączone przekraczają maksymalną długość zdefiniowaną przez system.
Obiekt wywołujący nie ma wymaganych uprawnień.
Obiekt wywołujący nie ma wymaganych uprawnień.
Uwagi
searchPattern może być kombinacją znaków literałów i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych. Następujące specyfikatory symboli wieloznacznych są dozwolone w pliku searchPattern.
| Specyfikator symboli wieloznacznych | Dopasowania |
|---|---|
| * (gwiazdka) | Zero lub więcej znaków w tej pozycji. |
| ? (pytajnik) | Dokładnie jeden znak w tej pozycji. |
Znaki inne niż symbol wieloznaczny to znaki literału. Na przykład searchPattern ciąg "*t" wyszukuje wszystkie nazwy kończące path się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy, path zaczynając od litery "s".
Note
W przypadku używania symbolu wieloznakowego gwiazdki w obiekcie searchPattern takim jak "*.txt" liczba znaków w określonym rozszerzeniu wpływa na wyszukiwanie w następujący sposób:
- Jeśli określone rozszerzenie ma dokładnie trzy znaki, metoda zwraca pliki z rozszerzeniami rozpoczynającymi się od określonego rozszerzenia. Na przykład wyrażenie "*.xls" zwraca wartość "book.xls" i "book.xlsx".
- We wszystkich innych przypadkach metoda zwraca pliki, które dokładnie pasują do określonego rozszerzenia. Na przykład wyrażenie "*.ai" zwraca wartość "file.ai", ale nie "file.aif".
Jeśli używasz symbolu wieloznakowego znaku zapytania, ta metoda zwraca tylko pliki zgodne z określonym rozszerzeniem pliku. Na przykład w przypadku dwóch plików "file1.txt" i "file1.txtother" w katalogu wzorzec wyszukiwania "plik?.txt" zwraca tylko pierwszy plik, natomiast wzorzec wyszukiwania "file*.txt" zwraca oba pliki.
searchPattern program nie może zakończyć się dwoma kropkami ("..") lub zawierać dwa kropki (".."), po DirectorySeparatorChar których następuje znak lub AltDirectorySeparatorChar, ani nie może zawierać żadnych nieprawidłowych znaków. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars metody .
Możesz określić informacje o ścieżce względnej za pomocą parametru path . Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego GetCurrentDirectory , który można określić przy użyciu metody .
Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: jeśli używasz EnumerateFileSystemEntriesmetody , możesz rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz GetFileSystemEntriesmetody , musisz poczekać na zwrócenie całej tablicy wpisów, zanim będzie można uzyskać dostęp do tablicy. W związku z tym podczas pracy z wieloma plikami i katalogami EnumerateFileSystemEntries może być wydajniejszy.
Zwrócona kolekcja nie jest buforowana; każde wywołanie GetEnumerator obiektu w kolekcji spowoduje uruchomienie nowego wyliczenia.
Dotyczy
EnumerateFileSystemEntries(String, String, EnumerationOptions)
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów, które są zgodne ze wzorcem wyszukiwania i opcjami wyliczania w określonej ścieżce.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)Parametry
- path
- String
Względna lub bezwzględna ścieżka do katalogu do wyszukania. Ten ciąg nie uwzględnia wielkości liter.
- searchPattern
- String
Ciąg wyszukiwania zgodny z nazwami plików i katalogów w pliku path. Ten parametr może zawierać kombinację prawidłowych literałów i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych.
- enumerationOptions
- EnumerationOptions
Obiekt opisujący konfigurację wyszukiwania i wyliczenia do użycia.
Zwraca
Wyliczalna kolekcja wpisów systemu plików w katalogu określonym przez path, które są zgodne z określonym wzorcem wyszukiwania i określonymi opcjami wyliczania.
Wyjątki
.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .
— lub —
searchPattern nie zawiera prawidłowego wzorca.
Parametr path ma wartość null.
— lub —
Parametr searchPattern ma wartość null.
path jest nieprawidłowy, na przykład odwoływania się do niezamapowanego dysku.
path to nazwa pliku.
Określona ścieżka, nazwa pliku lub połączone przekraczają maksymalną długość zdefiniowaną przez system.
Obiekt wywołujący nie ma wymaganych uprawnień.
Obiekt wywołujący nie ma wymaganych uprawnień.
Uwagi
searchPattern może być kombinacją znaków literałów i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych. Następujące specyfikatory symboli wieloznacznych są dozwolone w pliku searchPattern.
| Specyfikator symboli wieloznacznych | Dopasowania |
|---|---|
| * (gwiazdka) | Zero lub więcej znaków w tej pozycji. |
| ? (pytajnik) | Dokładnie jeden znak w tej pozycji. |
Znaki inne niż symbol wieloznaczny to znaki literału. Na przykład searchPattern ciąg "*t" wyszukuje wszystkie nazwy kończące path się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy, path zaczynając od litery "s".
Note
W przypadku używania symbolu wieloznakowego gwiazdki w obiekcie searchPattern takim jak "*.txt" liczba znaków w określonym rozszerzeniu wpływa na wyszukiwanie w następujący sposób:
- Jeśli określone rozszerzenie ma dokładnie trzy znaki, metoda zwraca pliki z rozszerzeniami rozpoczynającymi się od określonego rozszerzenia. Na przykład wyrażenie "*.xls" zwraca wartość "book.xls" i "book.xlsx".
- We wszystkich innych przypadkach metoda zwraca pliki, które dokładnie pasują do określonego rozszerzenia. Na przykład wyrażenie "*.ai" zwraca wartość "file.ai", ale nie "file.aif".
Jeśli używasz symbolu wieloznakowego znaku zapytania, ta metoda zwraca tylko pliki zgodne z określonym rozszerzeniem pliku. Na przykład w przypadku dwóch plików "file1.txt" i "file1.txtother" w katalogu wzorzec wyszukiwania "plik?.txt" zwraca tylko pierwszy plik, natomiast wzorzec wyszukiwania "file*.txt" zwraca oba pliki.
searchPattern program nie może zakończyć się dwoma kropkami ("..") lub zawierać dwa kropki (".."), po DirectorySeparatorChar których następuje znak lub AltDirectorySeparatorChar, ani nie może zawierać żadnych nieprawidłowych znaków. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars metody .
Możesz określić informacje o ścieżce względnej za pomocą parametru path . Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego GetCurrentDirectory , który można określić przy użyciu metody .
Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: jeśli używasz EnumerateFileSystemEntriesmetody , możesz rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz GetFileSystemEntriesmetody , musisz poczekać na zwrócenie całej tablicy wpisów, zanim będzie można uzyskać dostęp do tablicy. W związku z tym podczas pracy z wieloma plikami i katalogami EnumerateFileSystemEntries może być wydajniejszy.
Zwrócona kolekcja nie jest buforowana; każde wywołanie GetEnumerator obiektu w kolekcji spowoduje uruchomienie nowego wyliczenia.
Dotyczy
EnumerateFileSystemEntries(String, String, SearchOption)
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
- Źródło:
- Directory.cs
Zwraca wyliczaną kolekcję nazw plików i nazw katalogów pasujących do wzorca wyszukiwania w określonej ścieżce i opcjonalnie wyszukuje podkatalogi.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)Parametry
- path
- String
Względna lub bezwzględna ścieżka do katalogu do wyszukania. Ten ciąg nie uwzględnia wielkości liter.
- searchPattern
- String
Ciąg wyszukiwania zgodny z wpisami systemu plików w pliku .path Ten parametr może zawierać kombinację prawidłowych znaków literału i symboli wieloznacznych (* i ?), ale nie obsługuje wyrażeń regularnych.
- searchOption
- SearchOption
Jedną z wartości wyliczenia, która określa, czy operacja wyszukiwania powinna zawierać tylko bieżący katalog, czy powinna zawierać wszystkie podkatalogi. Wartość domyślna to TopDirectoryOnly.
Zwraca
Wyliczalna kolekcja wpisów systemu plików w katalogu określonym przez path program i pasujących do określonego wzorca wyszukiwania i opcji.
Wyjątki
.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .
— lub —
searchPattern nie zawiera prawidłowego wzorca.
Parametr path ma wartość null.
— lub —
Parametr searchPattern ma wartość null.
searchOption jest nieprawidłową SearchOption wartością.
path jest nieprawidłowy, na przykład odwoływania się do niezamapowanego dysku.
path to nazwa pliku.
Określona ścieżka, nazwa pliku lub połączone przekraczają maksymalną długość zdefiniowaną przez system.
Obiekt wywołujący nie ma wymaganych uprawnień.
Obiekt wywołujący nie ma wymaganych uprawnień.
Uwagi
searchPattern może być kombinacją znaków literałów i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych. Następujące specyfikatory symboli wieloznacznych są dozwolone w pliku searchPattern.
| Specyfikator symboli wieloznacznych | Dopasowania |
|---|---|
| * (gwiazdka) | Zero lub więcej znaków w tej pozycji. |
| ? (pytajnik) | Dokładnie jeden znak w tej pozycji. |
Znaki inne niż symbol wieloznaczny to znaki literału. Na przykład searchPattern ciąg "*t" wyszukuje wszystkie nazwy kończące path się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy, path zaczynając od litery "s".
Note
W przypadku używania symbolu wieloznakowego gwiazdki w obiekcie searchPattern takim jak "*.txt" liczba znaków w określonym rozszerzeniu wpływa na wyszukiwanie w następujący sposób:
- Jeśli określone rozszerzenie ma dokładnie trzy znaki, metoda zwraca pliki z rozszerzeniami rozpoczynającymi się od określonego rozszerzenia. Na przykład wyrażenie "*.xls" zwraca wartość "book.xls" i "book.xlsx".
- We wszystkich innych przypadkach metoda zwraca pliki, które dokładnie pasują do określonego rozszerzenia. Na przykład wyrażenie "*.ai" zwraca wartość "file.ai", ale nie "file.aif".
Jeśli używasz symbolu wieloznakowego znaku zapytania, ta metoda zwraca tylko pliki zgodne z określonym rozszerzeniem pliku. Na przykład w przypadku dwóch plików "file1.txt" i "file1.txtother" w katalogu wzorzec wyszukiwania "plik?.txt" zwraca tylko pierwszy plik, natomiast wzorzec wyszukiwania "file*.txt" zwraca oba pliki.
searchPattern program nie może zakończyć się dwoma kropkami ("..") lub zawierać dwa kropki (".."), po DirectorySeparatorChar których następuje znak lub AltDirectorySeparatorChar, ani nie może zawierać żadnych nieprawidłowych znaków. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars metody .
Możesz określić informacje o ścieżce względnej za pomocą parametru path . Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego GetCurrentDirectory , który można określić przy użyciu metody .
Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: jeśli używasz EnumerateFileSystemEntriesmetody , możesz rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz GetFileSystemEntriesmetody , musisz poczekać na zwrócenie całej tablicy wpisów, zanim będzie można uzyskać dostęp do tablicy. W związku z tym podczas pracy z wieloma plikami i katalogami EnumerateFileSystemEntries może być wydajniejszy.
Zwrócona kolekcja nie jest buforowana; każde wywołanie GetEnumerator obiektu w kolekcji spowoduje uruchomienie nowego wyliczenia.
