Aracılığıyla paylaş


Directory.EnumerateFileSystemEntries Yöntem

Tanım

Belirtilen ölçütleri karşılayan dosya sistemi girdilerinin listelenebilir bir koleksiyonunu 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
Kaynak:
Directory.cs
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

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

Özel durumlar

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.

path, null değeridir.

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

path bir dosya adıdır.

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

Çağıranın gerekli izni yok.

Ç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.

Şunlara uygulanır

EnumerateFileSystemEntries(String, String)

Kaynak:
Directory.cs
Kaynak:
Directory.cs
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

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

Özel durumlar

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.

path, null değeridir.

-veya-

searchPattern, null değeridir.

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

path bir dosya adıdır.

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

Çağıranın gerekli izni yok.

Ç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.

Şunlara uygulanır

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Kaynak:
Directory.cs
Kaynak:
Directory.cs
Kaynak:
Directory.cs

Belirtilen yoldaki bir arama deseni ve numaralandırma seçenekleriyle 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, 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 dosya ve 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

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

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.

path, null değeridir.

-veya-

searchPattern, null değeridir.

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

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

path bir dosya adıdır.

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

Çağıranın gerekli izni yok.

Ç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 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, koleksiyonun tamamı döndürülmeden önce girdi koleksiyonunu listelemeye başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmek 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.

Şunlara uygulanır

EnumerateFileSystemEntries(String, String, SearchOption)

Kaynak:
Directory.cs
Kaynak:
Directory.cs
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 girişleriyle patheşleşecek arama dizesi. Bu parametre geçerli değişmez değer yolu ve joker karakter (* ve ?) karakterlerinin 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

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

Özel durumlar

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.

path, null değeridir.

-veya-

searchPattern, null değeridir.

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

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

path bir dosya adıdır.

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

Çağıranın gerekli izni yok.

Ç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 konumdaki 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.

Not

"*.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 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, koleksiyonun tamamı döndürülmeden önce girdi koleksiyonunu listelemeye başlayabilirsiniz; kullandığınızdaGetFileSystemEntries, diziye erişebilmek 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.

Şunlara uygulanır