Directory.EnumerateFileSystemEntries Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Belirtilen ölçütleri karşılayan dosya sistemi girdilerinden oluşan numaralandırılabilir bir koleksiyon döndürür.

Aşırı Yüklemeler

EnumerateFileSystemEntries(String)	Belirtilen yolda dosya adları ve dizin adlarından oluşan numaralandırılabilir bir koleksiyon döndürür.
EnumerateFileSystemEntries(String, String)	Belirtilen yoldaki bir arama deseni ile eşleşen listelenebilir bir dosya adları ve dizin adları koleksiyonu döndürür.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Belirtilen yoldaki arama deseni ve numaralandırma seçenekleriyle eşleşen numaralandırılabilir bir dosya adları ve dizin adları koleksiyonu döndürür.
EnumerateFileSystemEntries(String, String, SearchOption)	Belirtilen yoldaki bir arama deseni ile eşleşen ve isteğe bağlı olarak alt dizinleri arayan, listelenebilir bir dosya adları ve dizin adları koleksiyonu döndürür.

EnumerateFileSystemEntries(String)

Kaynak:

Directory.cs

Belirtilen yolda dosya adları ve dizin adlarından oluşan numaralandırılabilir bir koleksiyon döndürür.

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)

Parametreler

path

String

Aranacak dizinin göreli veya mutlak yolu. Bu dize, büyük küçük harf duyarlı değildir.

Döndürülenler

IEnumerable<String>

tarafından pathbelirtilen dizindeki dosya sistemi girdilerinin numaralandırılabilir koleksiyonu.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya geçersiz karakterler içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

ArgumentNullException

path, null değeridir.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurmak gibi geçersizdir.

IOException

path bir dosya adıdır.

PathTooLongException

Belirtilen yol, dosya adı veya birleştirilmiş, sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Çağıranın gerekli izni yok.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

Göreli yol bilgilerini parametresiyle path belirtebilirsiniz. Göreli yol bilgileri, yöntemini kullanarak belirleyebileceğiniz geçerli çalışma dizinine GetCurrentDirectory göre yorumlanır.

EnumerateFileSystemEntries ve GetFileSystemEntries yöntemleri aşağıdaki gibi farklılık gösterir: kullandığınızdaEnumerateFileSystemEntries, tüm koleksiyon döndürülmeden önce girdi koleksiyonunu numaralandırmaya başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmeniz için tüm girdi dizisinin döndürülmesini beklemeniz gerekir. Bu nedenle, birçok dosya ve dizinle EnumerateFileSystemEntries çalışırken daha verimli olabilir.

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki öğesine GetEnumerator yapılan her çağrı yeni bir numaralandırma başlatır.

EnumerateFileSystemEntries(String, String)

Kaynak:

Directory.cs

Belirtilen yoldaki bir arama deseni ile eşleşen listelenebilir bir dosya adları ve dizin adları koleksiyonu döndürür.

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)

Parametreler

path

String

Aranacak dizinin göreli veya mutlak yolu. Bu dize, büyük küçük harf duyarlı değildir.

searchPattern

String

içindeki dosya sistemi girdilerinin adlarıyla patheşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ile joker karakter (* ve ?) karakterlerin bir bileşimini içerebilir, ancak normal ifadeleri desteklemez.

Döndürülenler

IEnumerable<String>

ve tarafından belirtilen dizinde belirtilen arama deseni ile path eşleşen numaralandırılabilir dosya sistemi girdileri koleksiyonu.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya geçersiz karakterler içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null değeridir.

-veya-

searchPattern, null değeridir.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurmak gibi geçersizdir.

IOException

path bir dosya adıdır.

PathTooLongException

Belirtilen yol, dosya adı veya birleştirilmiş, sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Çağıranın gerekli izni yok.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

searchPattern değişmez karakter ve joker karakterlerin birleşimi olabilir, ancak normal ifadeleri desteklemez. içinde aşağıdaki joker karakter tanımlayıcılara izin verilir searchPattern.

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda tam olarak bir karakter var.

Joker karakter dışındaki karakterler değişmez karakterlerdir. Örneğin, searchPattern "*t" dizesi "t" harfiyle biten tüm adları path arar. searchPattern"s*" dizesi, "s" harfiyle başlayan tüm adları path arar.

Not

"*.txt" gibi bir searchPattern içinde yıldız joker karakteri kullandığınızda, belirtilen uzantıdaki karakter sayısı aramayı aşağıdaki gibi etkiler:

• Belirtilen uzantı tam olarak üç karakter uzunluğundaysa, yöntem belirtilen uzantıyla başlayan uzantılara sahip dosyaları döndürür. Örneğin, "*.xls" hem "book.xls" hem de "book.xlsx" döndürür.
• Diğer tüm durumlarda yöntemi, belirtilen uzantıyla tam olarak eşleşen dosyaları döndürür. Örneğin, "*.ai" "file.ai" döndürür ancak "file.aif" döndürmez.

Soru işareti joker karakterini kullandığınızda, bu yöntem yalnızca belirtilen dosya uzantısıyla eşleşen dosyaları döndürür. Örneğin, bir dizindeki "file1.txt" ve "file1.txtother" adlı iki dosyada "dosya?.txt" arama deseni yalnızca ilk dosyayı döndürürken, "dosya*.txt" arama deseni her iki dosyayı da döndürür.

searchPattern iki noktayla ("..") sona eremez veya iki nokta ("..") ve ardından DirectorySeparatorChar veya AltDirectorySeparatorCharile bitemez veya geçersiz karakter içeremez. yöntemini kullanarak GetInvalidPathChars geçersiz karakterleri sorgulayabilirsiniz.

Göreli yol bilgilerini parametresiyle path belirtebilirsiniz. Göreli yol bilgileri, yöntemini kullanarak belirleyebileceğiniz geçerli çalışma dizinine GetCurrentDirectory göre yorumlanır.

EnumerateFileSystemEntries ve GetFileSystemEntries yöntemleri aşağıdaki gibi farklılık gösterir: kullandığınızdaEnumerateFileSystemEntries, tüm koleksiyon döndürülmeden önce girdi koleksiyonunu numaralandırmaya başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmeniz için tüm girdi dizisinin döndürülmesini beklemeniz gerekir. Bu nedenle, birçok dosya ve dizinle EnumerateFileSystemEntries çalışırken daha verimli olabilir.

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki öğesine GetEnumerator yapılan her çağrı yeni bir numaralandırma başlatır.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Kaynak:

Directory.cs

Belirtilen yoldaki arama deseni ve numaralandırma seçenekleriyle eşleşen numaralandırılabilir bir dosya adları ve dizin adları koleksiyonu döndürür.

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)

Parametreler

path

String

Aranacak dizinin göreli veya mutlak yolu. Bu dize, büyük küçük harf duyarlı değildir.

searchPattern

String

içindeki alt dizin pathadlarla eşleşecek arama dizesi. Bu parametre geçerli değişmez değer ve joker karakterlerin birleşimini içerebilir, ancak normal ifadeleri desteklemez.

enumerationOptions

EnumerationOptions

Kullanılacak arama ve numaralandırma yapılandırmasını açıklayan bir nesne.

Döndürülenler

IEnumerable<String>

tarafından pathbelirtilen dizinde belirtilen arama deseni ve belirtilen numaralandırma seçenekleriyle eşleşen numaralandırılabilir dosya sistemi girdileri koleksiyonu.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya geçersiz karakterler içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null değeridir.

-veya-

searchPattern, null değeridir.

ArgumentOutOfRangeException

searchOption geçerli SearchOption bir değer değil.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurmak gibi geçersizdir.

IOException

path bir dosya adıdır.

PathTooLongException

Belirtilen yol, dosya adı veya birleştirilmiş, sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Çağıranın gerekli izni yok.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

searchPattern değişmez karakter ve joker karakterlerin birleşimi olabilir, ancak normal ifadeleri desteklemez. içinde aşağıdaki joker karakter tanımlayıcılara izin verilir searchPattern.

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda tam olarak bir karakter var.

Joker karakter dışındaki karakterler değişmez karakterlerdir. Örneğin, searchPattern "*t" dizesi "t" harfiyle biten tüm adları path arar. searchPattern"s*" dizesi, "s" harfiyle başlayan tüm adları path arar.

Not

"*.txt" gibi bir searchPattern içinde yıldız joker karakteri kullandığınızda, belirtilen uzantıdaki karakter sayısı aramayı aşağıdaki gibi etkiler:

• Belirtilen uzantı tam olarak üç karakter uzunluğundaysa, yöntem belirtilen uzantıyla başlayan uzantılara sahip dosyaları döndürür. Örneğin, "*.xls" hem "book.xls" hem de "book.xlsx" döndürür.
• Diğer tüm durumlarda yöntemi, belirtilen uzantıyla tam olarak eşleşen dosyaları döndürür. Örneğin, "*.ai" "file.ai" döndürür ancak "file.aif" döndürmez.

Soru işareti joker karakterini kullandığınızda, bu yöntem yalnızca belirtilen dosya uzantısıyla eşleşen dosyaları döndürür. Örneğin, bir dizindeki "file1.txt" ve "file1.txtother" adlı iki dosyada "dosya?.txt" arama deseni yalnızca ilk dosyayı döndürürken, "dosya*.txt" arama deseni her iki dosyayı da döndürür.

searchPattern iki noktayla ("..") sona eremez veya iki nokta ("..") ve ardından DirectorySeparatorChar veya AltDirectorySeparatorCharile bitemez veya geçersiz karakter içeremez. yöntemini kullanarak GetInvalidPathChars geçersiz karakterleri sorgulayabilirsiniz.

Göreli yol bilgilerini parametresiyle path belirtebilirsiniz. Göreli yol bilgileri, yöntemini kullanarak belirleyebileceğiniz geçerli çalışma dizinine GetCurrentDirectory göre yorumlanır.

EnumerateFileSystemEntries ve GetFileSystemEntries yöntemleri aşağıdaki gibi farklılık gösterir: kullandığınızdaEnumerateFileSystemEntries, tüm koleksiyon döndürülmeden önce girdi koleksiyonunu numaralandırmaya başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmeniz için tüm girdi dizisinin döndürülmesini beklemeniz gerekir. Bu nedenle, birçok dosya ve dizinle EnumerateFileSystemEntries çalışırken daha verimli olabilir.

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki öğesine GetEnumerator yapılan her çağrı yeni bir numaralandırma başlatır.

EnumerateFileSystemEntries(String, String, SearchOption)

Kaynak:

Directory.cs

Belirtilen yoldaki bir arama deseni ile eşleşen ve isteğe bağlı olarak alt dizinleri arayan, listelenebilir bir dosya adları ve dizin adları koleksiyonu döndürür.

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)

Parametreler

path

String

Aranacak dizinin göreli veya mutlak yolu. Bu dize, büyük küçük harf duyarlı değildir.

searchPattern

String

içindeki dosya sistemi girdileriyle patheşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ile joker karakter (* ve ?) karakterlerin bir bileşimini içerebilir, ancak normal ifadeleri desteklemez.

searchOption

SearchOption

Arama işleminin yalnızca geçerli dizini mi yoksa tüm alt dizinleri mi içermesi gerektiğini belirten numaralandırma değerlerinden biri. TopDirectoryOnly varsayılan değerdir.

Döndürülenler

IEnumerable<String>

ve tarafından path belirtilen dizinde belirtilen arama deseni ve seçeneğiyle eşleşen numaralandırılabilir dosya sistemi girdileri koleksiyonu.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya geçersiz karakterler içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null değeridir.

-veya-

searchPattern, null değeridir.

ArgumentOutOfRangeException

searchOption geçerli SearchOption bir değer değil.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurmak gibi geçersizdir.

IOException

path bir dosya adıdır.

PathTooLongException

Belirtilen yol, dosya adı veya birleştirilmiş, sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Çağıranın gerekli izni yok.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

searchPattern değişmez karakter ve joker karakterlerin birleşimi olabilir, ancak normal ifadeleri desteklemez. içinde aşağıdaki joker karakter tanımlayıcılara izin verilir searchPattern.

Joker karakter tanımlayıcısı	Eşleşmeler
* (yıldız işareti)	Bu konumda sıfır veya daha fazla karakter.
? (soru işareti)	Bu konumda tam olarak bir karakter var.

Joker karakter dışındaki karakterler değişmez karakterlerdir. Örneğin, searchPattern "*t" dizesi "t" harfiyle biten tüm adları path arar. searchPattern"s*" dizesi, "s" harfiyle başlayan tüm adları path arar.

Not

"*.txt" gibi bir searchPattern içinde yıldız joker karakteri kullandığınızda, belirtilen uzantıdaki karakter sayısı aramayı aşağıdaki gibi etkiler:

• Belirtilen uzantı tam olarak üç karakter uzunluğundaysa, yöntem belirtilen uzantıyla başlayan uzantılara sahip dosyaları döndürür. Örneğin, "*.xls" hem "book.xls" hem de "book.xlsx" döndürür.
• Diğer tüm durumlarda yöntemi, belirtilen uzantıyla tam olarak eşleşen dosyaları döndürür. Örneğin, "*.ai" "file.ai" döndürür ancak "file.aif" döndürmez.

Soru işareti joker karakterini kullandığınızda, bu yöntem yalnızca belirtilen dosya uzantısıyla eşleşen dosyaları döndürür. Örneğin, bir dizindeki "file1.txt" ve "file1.txtother" adlı iki dosyada "dosya?.txt" arama deseni yalnızca ilk dosyayı döndürürken, "dosya*.txt" arama deseni her iki dosyayı da döndürür.

searchPattern iki noktayla ("..") sona eremez veya iki nokta ("..") ve ardından DirectorySeparatorChar veya AltDirectorySeparatorCharile bitemez veya geçersiz karakter içeremez. yöntemini kullanarak GetInvalidPathChars geçersiz karakterleri sorgulayabilirsiniz.

Göreli yol bilgilerini parametresiyle path belirtebilirsiniz. Göreli yol bilgileri, yöntemini kullanarak belirleyebileceğiniz geçerli çalışma dizinine GetCurrentDirectory göre yorumlanır.

EnumerateFileSystemEntries ve GetFileSystemEntries yöntemleri aşağıdaki gibi farklılık gösterir: kullandığınızdaEnumerateFileSystemEntries, tüm koleksiyon döndürülmeden önce girdi koleksiyonunu numaralandırmaya başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmeniz için tüm girdi dizisinin döndürülmesini beklemeniz gerekir. Bu nedenle, birçok dosya ve dizinle EnumerateFileSystemEntries çalışırken daha verimli olabilir.

Döndürülen koleksiyon önbelleğe alınmaz; koleksiyondaki öğesine GetEnumerator yapılan her çağrı yeni bir numaralandırma başlatır.