Directory.EnumerateFileSystemEntries Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Mengembalikan kumpulan entri sistem file yang dapat dijumlahkan yang memenuhi kriteria yang ditentukan.

Overload

EnumerateFileSystemEntries(String)	Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan dalam jalur tertentu.
EnumerateFileSystemEntries(String, String)	Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dalam jalur tertentu.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dan opsi enumerasi dalam jalur tertentu.
EnumerateFileSystemEntries(String, String, SearchOption)	Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian di jalur tertentu, dan secara opsional mencari subdirektori.

EnumerateFileSystemEntries(String)

Sumber:

Directory.cs

Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan dalam jalur tertentu.

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)

Parameter

path

String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

Mengembalikan

IEnumerable<String>

Kumpulan entri sistem file yang dapat dijumlahkan dalam direktori yang ditentukan oleh path.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

ArgumentNullException

pathadalah null.

DirectoryNotFoundException

path tidak valid, seperti mengacu pada drive yang tidak dipetakan.

IOException

path adalah nama file.

PathTooLongException

Jalur yang ditentukan, nama file, atau gabungan melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

Anda dapat menentukan informasi jalur relatif dengan path parameter . Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini, yang dapat Anda tentukan dengan menggunakan GetCurrentDirectory metode .

Metode EnumerateFileSystemEntries dan GetFileSystemEntries berbeda sebagai berikut: Ketika Anda menggunakan EnumerateFileSystemEntries, Anda dapat mulai menghitung koleksi entri sebelum seluruh koleksi dikembalikan; ketika Anda menggunakan GetFileSystemEntries, Anda harus menunggu seluruh array entri dikembalikan sebelum Anda dapat mengakses array. Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateFileSystemEntries bisa lebih efisien.

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator pada koleksi akan memulai enumerasi baru.

EnumerateFileSystemEntries(String, String)

Sumber:

Directory.cs

Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dalam jalur tertentu.

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)

Parameter

path

String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern

String

String pencarian yang cocok dengan nama entri sistem file di path. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

Mengembalikan

IEnumerable<String>

Kumpulan entri sistem file yang dapat dijumlahkan dalam direktori yang ditentukan oleh dan yang cocok dengan path pola pencarian yang ditentukan.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

pathadalah null.

-atau-

searchPatternadalah null.

DirectoryNotFoundException

path tidak valid, seperti mengacu pada drive yang tidak dipetakan.

IOException

path adalah nama file.

PathTooLongException

Jalur yang ditentukan, nama file, atau gabungan melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, searchPattern string "*t" mencari semua nama yang path berakhiran dengan huruf "t". String searchPattern "s*" mencari semua nama yang path dimulai dengan huruf "s".

Catatan

Saat Anda menggunakan karakter kartubebas tanda bintang di searchPattern seperti "*.txt", jumlah karakter dalam ekstensi yang ditentukan memengaruhi pencarian sebagai berikut:

• Jika ekstensi yang ditentukan memiliki panjang tepat tiga karakter, metode mengembalikan file dengan ekstensi yang dimulai dengan ekstensi yang ditentukan. Misalnya, "*.xls" mengembalikan "book.xls" dan "book.xlsx".
• Dalam semua kasus lain, metode mengembalikan file yang sama persis dengan ekstensi yang ditentukan. Misalnya, "*.ai" mengembalikan "file.ai" tetapi bukan "file.aif".

Saat Anda menggunakan karakter kartubebas tanda tanya, metode ini hanya mengembalikan file yang cocok dengan ekstensi file yang ditentukan. Misalnya, diberikan dua file, "file1.txt" dan "file1.txtother", dalam direktori, pola pencarian "file?.txt" hanya mengembalikan file pertama, sedangkan pola pencarian "file*.txt" mengembalikan kedua file.

searchPattern tidak dapat berakhir dalam dua titik ("..") atau berisi dua titik ("..") diikuti oleh DirectorySeparatorChar atau AltDirectorySeparatorChar, juga tidak boleh berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars

Anda dapat menentukan informasi jalur relatif dengan path parameter . Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini, yang dapat Anda tentukan dengan menggunakan GetCurrentDirectory metode .

Metode EnumerateFileSystemEntries dan GetFileSystemEntries berbeda sebagai berikut: Ketika Anda menggunakan EnumerateFileSystemEntries, Anda dapat mulai menghitung koleksi entri sebelum seluruh koleksi dikembalikan; ketika Anda menggunakan GetFileSystemEntries, Anda harus menunggu seluruh array entri dikembalikan sebelum Anda dapat mengakses array. Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateFileSystemEntries bisa lebih efisien.

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator pada koleksi akan memulai enumerasi baru.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Sumber:

Directory.cs

Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian dan opsi enumerasi dalam jalur tertentu.

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)

Parameter

path

String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern

String

String pencarian yang cocok dengan nama subdirektori di path. Parameter ini dapat berisi kombinasi karakter literal dan wildcard yang valid, tetapi tidak mendukung ekspresi reguler.

enumerationOptions

EnumerationOptions

Objek yang menjelaskan konfigurasi pencarian dan enumerasi untuk digunakan.

Mengembalikan

IEnumerable<String>

Kumpulan entri sistem file yang dapat dijumlahkan dalam direktori yang ditentukan oleh , yang cocok dengan pathpola pencarian yang ditentukan dan opsi enumerasi yang ditentukan.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

pathadalah null.

-atau-

searchPatternadalah null.

ArgumentOutOfRangeException

searchOption bukan nilai yang valid SearchOption .

DirectoryNotFoundException

path tidak valid, seperti mengacu pada drive yang tidak dipetakan.

IOException

path adalah nama file.

PathTooLongException

Jalur yang ditentukan, nama file, atau gabungan melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, searchPattern string "*t" mencari semua nama yang path berakhiran dengan huruf "t". String searchPattern "s*" mencari semua nama yang path dimulai dengan huruf "s".

Catatan

Saat Anda menggunakan karakter kartubebas tanda bintang di searchPattern seperti "*.txt", jumlah karakter dalam ekstensi yang ditentukan memengaruhi pencarian sebagai berikut:

• Jika ekstensi yang ditentukan memiliki panjang tepat tiga karakter, metode mengembalikan file dengan ekstensi yang dimulai dengan ekstensi yang ditentukan. Misalnya, "*.xls" mengembalikan "book.xls" dan "book.xlsx".
• Dalam semua kasus lain, metode mengembalikan file yang sama persis dengan ekstensi yang ditentukan. Misalnya, "*.ai" mengembalikan "file.ai" tetapi bukan "file.aif".

Saat Anda menggunakan karakter kartubebas tanda tanya, metode ini hanya mengembalikan file yang cocok dengan ekstensi file yang ditentukan. Misalnya, diberikan dua file, "file1.txt" dan "file1.txtother", dalam direktori, pola pencarian "file?.txt" hanya mengembalikan file pertama, sedangkan pola pencarian "file*.txt" mengembalikan kedua file.

searchPattern tidak dapat berakhir dalam dua titik ("..") atau berisi dua titik ("..") diikuti oleh DirectorySeparatorChar atau AltDirectorySeparatorChar, juga tidak boleh berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars

Anda dapat menentukan informasi jalur relatif dengan path parameter . Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini, yang dapat Anda tentukan dengan menggunakan GetCurrentDirectory metode .

Metode EnumerateFileSystemEntries dan GetFileSystemEntries berbeda sebagai berikut: Ketika Anda menggunakan EnumerateFileSystemEntries, Anda dapat mulai menghitung koleksi entri sebelum seluruh koleksi dikembalikan; ketika Anda menggunakan GetFileSystemEntries, Anda harus menunggu seluruh array entri dikembalikan sebelum Anda dapat mengakses array. Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateFileSystemEntries bisa lebih efisien.

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator pada koleksi akan memulai enumerasi baru.

EnumerateFileSystemEntries(String, String, SearchOption)

Sumber:

Directory.cs

Mengembalikan kumpulan nama file dan nama direktori yang dapat dijumlahkan yang cocok dengan pola pencarian di jalur tertentu, dan secara opsional mencari subdirektori.

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)

Parameter

path

String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern

String

String pencarian yang cocok dengan entri sistem file di path. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

searchOption

SearchOption

Salah satu nilai enumerasi yang menentukan apakah operasi pencarian hanya boleh menyertakan direktori saat ini atau harus menyertakan semua subdirektori. Nilai defaultnya adalah TopDirectoryOnly.

Mengembalikan

IEnumerable<String>

Kumpulan entri sistem file yang dapat dijumlahkan dalam direktori yang ditentukan oleh dan yang cocok dengan path pola dan opsi pencarian yang ditentukan.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

pathadalah null.

-atau-

searchPatternadalah null.

ArgumentOutOfRangeException

searchOption bukan nilai yang valid SearchOption .

DirectoryNotFoundException

path tidak valid, seperti mengacu pada drive yang tidak dipetakan.

IOException

path adalah nama file.

PathTooLongException

Jalur yang ditentukan, nama file, atau gabungan melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, searchPattern string "*t" mencari semua nama yang path berakhiran dengan huruf "t". String searchPattern "s*" mencari semua nama yang path dimulai dengan huruf "s".

Catatan

Saat Anda menggunakan karakter kartubebas tanda bintang di searchPattern seperti "*.txt", jumlah karakter dalam ekstensi yang ditentukan memengaruhi pencarian sebagai berikut:

• Jika ekstensi yang ditentukan memiliki panjang tepat tiga karakter, metode mengembalikan file dengan ekstensi yang dimulai dengan ekstensi yang ditentukan. Misalnya, "*.xls" mengembalikan "book.xls" dan "book.xlsx".
• Dalam semua kasus lain, metode mengembalikan file yang sama persis dengan ekstensi yang ditentukan. Misalnya, "*.ai" mengembalikan "file.ai" tetapi bukan "file.aif".

Saat Anda menggunakan karakter kartubebas tanda tanya, metode ini hanya mengembalikan file yang cocok dengan ekstensi file yang ditentukan. Misalnya, diberikan dua file, "file1.txt" dan "file1.txtother", dalam direktori, pola pencarian "file?.txt" hanya mengembalikan file pertama, sedangkan pola pencarian "file*.txt" mengembalikan kedua file.

searchPattern tidak dapat berakhir dalam dua titik ("..") atau berisi dua titik ("..") diikuti oleh DirectorySeparatorChar atau AltDirectorySeparatorChar, juga tidak boleh berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars

Anda dapat menentukan informasi jalur relatif dengan path parameter . Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini, yang dapat Anda tentukan dengan menggunakan GetCurrentDirectory metode .

Metode EnumerateFileSystemEntries dan GetFileSystemEntries berbeda sebagai berikut: Ketika Anda menggunakan EnumerateFileSystemEntries, Anda dapat mulai menghitung koleksi entri sebelum seluruh koleksi dikembalikan; ketika Anda menggunakan GetFileSystemEntries, Anda harus menunggu seluruh array entri dikembalikan sebelum Anda dapat mengakses array. Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateFileSystemEntries bisa lebih efisien.

Koleksi yang dikembalikan tidak di-cache; setiap panggilan ke GetEnumerator pada koleksi akan memulai enumerasi baru.