Directory.EnumerateFileSystemEntries Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 path
belirtilen 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 path
eş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
, 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 path
adlarla 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 path
belirtilen 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.
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 path
eş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.
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.