Udostępnij za pośrednictwem


Directory.EnumerateFileSystemEntries Metoda

Definicja

Zwraca wyliczaną kolekcję wpisów systemu plików spełniających określone kryteria.

Przeciążenia

EnumerateFileSystemEntries(String)

Zwraca wyliczalną kolekcję nazw plików i nazw katalogów w określonej ścieżce.

EnumerateFileSystemEntries(String, String)

Zwraca wyliczalną kolekcję nazw plików i nazw katalogów pasujących do wzorca wyszukiwania w określonej ścieżce.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Zwraca wyliczalną kolekcję nazw plików i nazw katalogów pasujących do wzorca wyszukiwania i opcji wyliczenia w określonej ścieżce.

EnumerateFileSystemEntries(String, String, SearchOption)

Zwraca wyliczalną 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

Zwraca wyliczalną 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

Ścieżka względna lub bezwzględna do katalogu do wyszukiwania. W tym ciągu nie jest rozróżniana wielkość liter.

Zwraca

Wyliczenie kolekcji wpisów systemu plików w katalogu określonym przez pathprogram .

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 .

path to 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łączenie przekraczają maksymalną długość zdefiniowaną przez system.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Obiekt wywołujący nie posiada 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, który można określić przy użyciu GetCurrentDirectory metody .

Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: w przypadku używania metody można rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz EnumerateFileSystemEntriesGetFileSystemEntriesmetody , 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 elementu GetEnumerator w kolekcji rozpocznie nową wyliczenie.

Dotyczy

EnumerateFileSystemEntries(String, String)

Źródło:
Directory.cs
Źródło:
Directory.cs
Źródło:
Directory.cs

Zwraca wyliczalną kolekcję nazw plików i nazw katalogów pasujących 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

Ścieżka względna lub bezwzględna do katalogu do wyszukiwania. W tym ciągu nie jest rozróżniana wielkość 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

Wyliczenie kolekcji wpisów systemu plików w katalogu określonym przez path i które są zgodne z określonym wzorcem 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.

path to null.

-lub-

searchPattern to 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łączenie przekraczają maksymalną długość zdefiniowaną przez system.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

searchPattern może być kombinacją 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 Jest zgodny z
* (gwiazdka) Zero lub więcej znaków w tej pozycji.
? (znak zapytania) 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 path kończące się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy path na początku litery "s".

Uwaga

Jeśli używasz symbolu wieloznakowego gwiazdki, takiego searchPattern 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 zarówno "book.xls" jak 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".

W przypadku używania 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 "file?.txt" zwraca tylko pierwszy plik, podczas gdy wzorzec wyszukiwania "file*.txt" zwraca oba pliki.

searchPattern nie może kończyć się dwoma kropkami ("..") lub zawierać dwa kropki (".)."), po DirectorySeparatorChar których następuje 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, który można określić przy użyciu GetCurrentDirectory metody .

Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: w przypadku używania metody można rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. Jeśli używasz EnumerateFileSystemEntriesGetFileSystemEntriesmetody , 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 elementu GetEnumerator w kolekcji rozpocznie nową wyliczenie.

Dotyczy

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Ź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 i opcji wyliczenia 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

Ścieżka względna lub bezwzględna do katalogu do wyszukiwania. W tym ciągu nie jest rozróżniana wielkość 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.

path to null.

-lub-

searchPattern to 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łączenie przekraczają maksymalną długość zdefiniowaną przez system.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

searchPattern może być kombinacją 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 Jest zgodny z
* (gwiazdka) Zero lub więcej znaków w tej pozycji.
? (znak zapytania) 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 path kończące się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy, path zaczynając od litery "s".

Uwaga

W przypadku używania znaku 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 długości, metoda zwraca pliki z rozszerzeniami rozpoczynającymi się od określonego rozszerzenia. Na przykład wyrażenie "*.xls" zwraca zarówno "book.xls", jak 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 "file?.txt" zwraca tylko pierwszy plik, podczas gdy wzorzec wyszukiwania "file*.txt" zwraca oba pliki.

searchPattern program nie może kończyć się dwoma kropkami ("..") ani zawierać dwóch kropek (".."), po których następuje DirectorySeparatorChar znak lub AltDirectorySeparatorChar, ani nie może zawierać żadnych nieprawidłowych znaków. Zapytania dotyczące nieprawidłowych znaków można wykonać 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, który można określić przy użyciu GetCurrentDirectory metody .

Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: w przypadku użycia EnumerateFileSystemEntriesmetody można rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. W przypadku użycia GetFileSystemEntriesmetody należy 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

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

Ścieżka względna lub bezwzględna do katalogu do wyszukania. W tym ciągu nie jest rozróżniana wielkość liter.

searchPattern
String

Ciąg wyszukiwania, który ma być zgodny z wpisami systemu plików w pliku .path Ten parametr może zawierać kombinację prawidłowych znaków ścieżki literału i symboli wieloznacznych (* i ?), ale nie obsługuje wyrażeń regularnych.

searchOption
SearchOption

Jedna z wartości wyliczenia określająca, 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 jest zgodna z określonym wzorcem wyszukiwania i opcją.

Wyjątki

Programy .NET Framework i .NET Core starsze niż 2.1: path to ciąg o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

-lub-

searchPattern nie zawiera prawidłowego wzorca.

path to null.

-lub-

searchPattern to null.

searchOption jest nieprawidłową SearchOption wartością.

path jest nieprawidłowy, na przykład odwołując się do niezamapowanego dysku.

path to nazwa pliku.

Określona ścieżka, nazwa pliku lub łączna długość przekracza zdefiniowaną przez system maksymalną długość.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

searchPattern może być kombinacją literałów i symboli wieloznacznych, ale nie obsługuje wyrażeń regularnych. Następujące specyfikatory symboli wieloznacznych są dozwolone w programie searchPattern.

Specyfikator symboli wieloznacznych Jest zgodny z
* (gwiazdka) Zero lub więcej znaków w tej pozycji.
? (znak zapytania) 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 path kończące się literą "t". Ciąg searchPattern "s*" wyszukuje wszystkie nazwy, path zaczynając od litery "s".

Uwaga

W przypadku używania znaku 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 długości, metoda zwraca pliki z rozszerzeniami rozpoczynającymi się od określonego rozszerzenia. Na przykład wyrażenie "*.xls" zwraca zarówno "book.xls", jak 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 "file?.txt" zwraca tylko pierwszy plik, podczas gdy wzorzec wyszukiwania "file*.txt" zwraca oba pliki.

searchPattern program nie może kończyć się dwoma kropkami ("..") ani zawierać dwóch kropek (".."), po których następuje DirectorySeparatorChar znak lub AltDirectorySeparatorChar, ani nie może zawierać żadnych nieprawidłowych znaków. Zapytania dotyczące nieprawidłowych znaków można wykonać 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, który można określić przy użyciu GetCurrentDirectory metody .

Metody EnumerateFileSystemEntries i GetFileSystemEntries różnią się w następujący sposób: w przypadku użycia EnumerateFileSystemEntriesmetody można rozpocząć wyliczanie kolekcji wpisów przed zwróceniem całej kolekcji. W przypadku użycia GetFileSystemEntriesmetody należy 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