Directory.EnumerateFileSystemEntries Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Belirtilen ölçütleri karşılayan dosya sistemi girdilerinin numaralandırılabilir bir koleksiyonunu döndürür.

Aşırı Yüklemeler

Name	Description
EnumerateFileSystemEntries(String)	Belirtilen yolda dosya adlarının ve dizin adlarının listelenebilir bir koleksiyonunu döndürür.
EnumerateFileSystemEntries(String, String)	Belirtilen yoldaki bir arama deseni ile eşleşen dosya adları ve dizin adlarından oluşan numaralandırılabilir bir koleksiyon döndürür.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Belirtilen yoldaki arama deseni ve numaralandırma seçenekleriyle eşleşen dosya adları ve dizin adlarından oluşan numaralandırılabilir bir koleksiyon 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, numaralandırılabilir bir dosya adları ve dizin adları koleksiyonu döndürür.

EnumerateFileSystemEntries(String)

Kaynak:

Directory.cs

Belirtilen yolda dosya adlarının ve dizin adlarının listelenebilir bir koleksiyonunu 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 harfe duyarlı değildir.

Döndürülenler

IEnumerable<String>

tarafından pathbelirtilen dizinde 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. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

ArgumentNullException

path, null'e eşittir.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurma 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

parametresiyle path göreli yol bilgilerini 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 önce 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 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, 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 harfe 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>

tarafından path belirtilen ve belirtilen arama deseni ile eşleşen 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. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null'e eşittir.

-veya-

searchPattern, null'e eşittir.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurma 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.

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.

Note

"*.txt" gibi bir searchPattern 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 dizinde "file1.txt" ve "file1.txtother" adlı iki dosya ve "dosya?.txt" yalnızca ilk dosyayı döndürürken, "file*.txt" arama deseni her iki dosyayı da döndürür.

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

parametresiyle path göreli yol bilgilerini 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 önce 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 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, 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 harfe duyarlı değildir.

searchPattern

String

içindeki dosya ve dizin pathadlarına göre eşleşecek arama dizesi. Bu parametre geçerli değişmez karakter 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 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 bir 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. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null'e eşittir.

-veya-

searchPattern, null'e eşittir.

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurma 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.

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.

Note

"*.txt" gibi bir searchPattern 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 dizinde "file1.txt" ve "file1.txtother" adlı iki dosya ve "dosya?.txt" yalnızca ilk dosyayı döndürürken, "file*.txt" arama deseni her iki dosyayı da döndürür.

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

parametresiyle path göreli yol bilgilerini 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 önce 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, 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::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 harfe 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>

tarafından path belirtilen ve belirtilen arama deseni ve seçeneğiyle eşleşen 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. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

-veya-

searchPattern geçerli bir desen içermiyor.

ArgumentNullException

path, null'e eşittir.

-veya-

searchPattern, null'e eşittir.

ArgumentOutOfRangeException

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

DirectoryNotFoundException

path , eşlenmemiş bir sürücüye başvurma 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.

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.

Note

"*.txt" gibi bir searchPattern 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 dizinde "file1.txt" ve "file1.txtother" adlı iki dosya ve "dosya?.txt" yalnızca ilk dosyayı döndürürken, "file*.txt" arama deseni her iki dosyayı da döndürür.

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

parametresiyle path göreli yol bilgilerini 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 önce 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.