Directory.EnumerateFileSystemEntries Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een inventariserbare verzameling bestandssysteemvermeldingen die voldoen aan de opgegeven criteria.
Overloads
| Name | Description |
|---|---|
| EnumerateFileSystemEntries(String) |
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen in een opgegeven pad. |
| EnumerateFileSystemEntries(String, String) |
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon in een opgegeven pad. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon en opsommingsopties in een opgegeven pad. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon in een opgegeven pad en zoekt desgewenst submappen. |
EnumerateFileSystemEntries(String)
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen in een opgegeven pad.
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)Parameters
- path
- String
Het relatieve of absolute pad naar de map om te zoeken. Deze tekenreeks is niet hoofdlettergevoelig.
Retouren
Een inventariserbare verzameling bestandssysteemvermeldingen in de map die is opgegeven door path.
Uitzonderingen
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
path is ongeldig, zoals het verwijzen naar een niet-toegewezen station.
path is een bestandsnaam.
Het opgegeven pad, de bestandsnaam of de gecombineerde waarde overschrijdt de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
De beller heeft niet de vereiste machtiging.
Opmerkingen
U kunt relatieve padgegevens opgeven met de path parameter. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap, die u kunt bepalen met behulp van de GetCurrentDirectory methode.
De EnumerateFileSystemEntries en GetFileSystemEntries methoden verschillen als volgt: Wanneer u gebruikt EnumerateFileSystemEntries, kunt u beginnen met het inventariseren van de verzameling vermeldingen voordat de hele verzameling wordt geretourneerd. Wanneer u deze gebruikt GetFileSystemEntries, moet u wachten totdat de hele matrix met vermeldingen wordt geretourneerd voordat u toegang hebt tot de matrix. Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFileSystemEntries werkt.
De geretourneerde verzameling wordt niet in de cache opgeslagen; bij elke aanroep van de GetEnumerator verzameling wordt een nieuwe inventarisatie gestart.
Van toepassing op
EnumerateFileSystemEntries(String, String)
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon in een opgegeven pad.
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)Parameters
- path
- String
Het relatieve of absolute pad naar de map om te zoeken. Deze tekenreeks is niet hoofdlettergevoelig.
- searchPattern
- String
De zoektekenreeks die overeenkomt met de namen van bestandssysteemvermeldingen in path. Deze parameter kan een combinatie van geldig letterlijke tekens en jokertekens (* en ?) bevatten, maar biedt geen ondersteuning voor reguliere expressies.
Retouren
Een inventariserbare verzameling bestandssysteemvermeldingen in de map die is opgegeven door path en die overeenkomen met het opgegeven zoekpatroon.
Uitzonderingen
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
– of –
searchPattern bevat geen geldig patroon.
path is ongeldig, zoals het verwijzen naar een niet-toegewezen station.
path is een bestandsnaam.
Het opgegeven pad, de bestandsnaam of de gecombineerde waarde overschrijdt de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
De beller heeft niet de vereiste machtiging.
Opmerkingen
searchPattern kan een combinatie zijn van letterlijke tekens en jokertekens, maar biedt geen ondersteuning voor reguliere expressies. De volgende jokertekenaanduidingen zijn toegestaan in searchPattern.
| Jokertekenaanduiding | Overeenkomsten |
|---|---|
| * (sterretje) | Nul of meer tekens op die positie. |
| ? (vraagteken) | Precies één teken in die positie. |
Andere tekens dan het jokerteken zijn letterlijke tekens. Met de searchPattern tekenreeks '*t' wordt bijvoorbeeld gezocht naar alle namen die path eindigen op de letter 't'. De searchPattern tekenreeks 's*' zoekt naar alle namen in path het begin met de letter 's'.
Note
Wanneer u het jokerteken sterretje gebruikt in een searchPattern zoals '*.txt', is het aantal tekens in de opgegeven extensie als volgt van invloed op de zoekopdracht:
- Als de opgegeven extensie precies drie tekens lang is, retourneert de methode bestanden met extensies die beginnen met de opgegeven extensie. Bijvoorbeeld: '*.xls' retourneert zowel 'book.xls' als 'book.xlsx'.
- In alle andere gevallen retourneert de methode bestanden die exact overeenkomen met de opgegeven extensie. *.ai retourneert bijvoorbeeld 'file.ai' maar niet 'file.aif'.
Wanneer u het vraagteken jokerteken gebruikt, retourneert deze methode alleen bestanden die overeenkomen met de opgegeven bestandsextensie. Bijvoorbeeld, gegeven twee bestanden, 'file1.txt' en 'file1.txtother', in een map, een zoekpatroon van 'bestand?'.txt" retourneert alleen het eerste bestand, terwijl een zoekpatroon van 'bestand*.txt' beide bestanden retourneert.
searchPattern kan niet eindigen in twee perioden ("..") of twee punten ("."), gevolgd door DirectorySeparatorChar of AltDirectorySeparatorChar, noch mogen deze ongeldige tekens bevatten. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars methode.
U kunt relatieve padgegevens opgeven met de path parameter. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap, die u kunt bepalen met behulp van de GetCurrentDirectory methode.
De EnumerateFileSystemEntries en GetFileSystemEntries methoden verschillen als volgt: Wanneer u gebruikt EnumerateFileSystemEntries, kunt u beginnen met het inventariseren van de verzameling vermeldingen voordat de hele verzameling wordt geretourneerd. Wanneer u deze gebruikt GetFileSystemEntries, moet u wachten totdat de hele matrix met vermeldingen wordt geretourneerd voordat u toegang hebt tot de matrix. Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFileSystemEntries werkt.
De geretourneerde verzameling wordt niet in de cache opgeslagen; bij elke aanroep van de GetEnumerator verzameling wordt een nieuwe inventarisatie gestart.
Van toepassing op
EnumerateFileSystemEntries(String, String, EnumerationOptions)
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon en opsommingsopties in een opgegeven pad.
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)Parameters
- path
- String
Het relatieve of absolute pad naar de map om te zoeken. Deze tekenreeks is niet hoofdlettergevoelig.
- searchPattern
- String
De zoekreeks die overeenkomt met de namen van bestanden en mappen in path. Deze parameter kan een combinatie van geldige letterlijke en jokertekens bevatten, maar biedt geen ondersteuning voor reguliere expressies.
- enumerationOptions
- EnumerationOptions
Een object dat de zoek- en opsommingsconfiguratie beschrijft die moet worden gebruikt.
Retouren
Een inventariserbare verzameling bestandssysteemvermeldingen in de map die is opgegeven door path, die overeenkomen met het opgegeven zoekpatroon en de opgegeven opsommingsopties.
Uitzonderingen
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
– of –
searchPattern bevat geen geldig patroon.
path is ongeldig, zoals het verwijzen naar een niet-toegewezen station.
path is een bestandsnaam.
Het opgegeven pad, de bestandsnaam of de gecombineerde waarde overschrijdt de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
De beller heeft niet de vereiste machtiging.
Opmerkingen
searchPattern kan een combinatie zijn van letterlijke tekens en jokertekens, maar biedt geen ondersteuning voor reguliere expressies. De volgende jokertekenaanduidingen zijn toegestaan in searchPattern.
| Jokertekenaanduiding | Overeenkomsten |
|---|---|
| * (sterretje) | Nul of meer tekens op die positie. |
| ? (vraagteken) | Precies één teken in die positie. |
Andere tekens dan het jokerteken zijn letterlijke tekens. Met de searchPattern tekenreeks '*t' wordt bijvoorbeeld gezocht naar alle namen die path eindigen op de letter 't'. De searchPattern tekenreeks 's*' zoekt naar alle namen in path het begin met de letter 's'.
Note
Wanneer u het jokerteken sterretje gebruikt in een searchPattern zoals '*.txt', is het aantal tekens in de opgegeven extensie als volgt van invloed op de zoekopdracht:
- Als de opgegeven extensie precies drie tekens lang is, retourneert de methode bestanden met extensies die beginnen met de opgegeven extensie. Bijvoorbeeld: '*.xls' retourneert zowel 'book.xls' als 'book.xlsx'.
- In alle andere gevallen retourneert de methode bestanden die exact overeenkomen met de opgegeven extensie. *.ai retourneert bijvoorbeeld 'file.ai' maar niet 'file.aif'.
Wanneer u het vraagteken jokerteken gebruikt, retourneert deze methode alleen bestanden die overeenkomen met de opgegeven bestandsextensie. Bijvoorbeeld, gegeven twee bestanden, 'file1.txt' en 'file1.txtother', in een map, een zoekpatroon van 'bestand?'.txt" retourneert alleen het eerste bestand, terwijl een zoekpatroon van 'bestand*.txt' beide bestanden retourneert.
searchPattern kan niet eindigen in twee perioden ("..") of twee punten ("."), gevolgd door DirectorySeparatorChar of AltDirectorySeparatorChar, noch mogen deze ongeldige tekens bevatten. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars methode.
U kunt relatieve padgegevens opgeven met de path parameter. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap, die u kunt bepalen met behulp van de GetCurrentDirectory methode.
De EnumerateFileSystemEntries en GetFileSystemEntries methoden verschillen als volgt: Wanneer u gebruikt EnumerateFileSystemEntries, kunt u beginnen met het inventariseren van de verzameling vermeldingen voordat de hele verzameling wordt geretourneerd. Wanneer u deze gebruikt GetFileSystemEntries, moet u wachten totdat de hele matrix met vermeldingen wordt geretourneerd voordat u toegang hebt tot de matrix. Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFileSystemEntries werkt.
De geretourneerde verzameling wordt niet in de cache opgeslagen; bij elke aanroep van de GetEnumerator verzameling wordt een nieuwe inventarisatie gestart.
Van toepassing op
EnumerateFileSystemEntries(String, String, SearchOption)
Retourneert een inventariserbare verzameling bestandsnamen en mapnamen die overeenkomen met een zoekpatroon in een opgegeven pad en zoekt desgewenst submappen.
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)Parameters
- path
- String
Het relatieve of absolute pad naar de map om te zoeken. Deze tekenreeks is niet hoofdlettergevoelig.
- searchPattern
- String
De zoekreeks die overeenkomt met bestandssysteemvermeldingen in path. Deze parameter kan een combinatie van geldig letterlijke tekens en jokertekens (* en ?) bevatten, maar biedt geen ondersteuning voor reguliere expressies.
- searchOption
- SearchOption
Een van de opsommingswaarden die aangeeft of de zoekbewerking alleen de huidige map moet bevatten of alle submappen moet bevatten. De standaardwaarde is TopDirectoryOnly.
Retouren
Een opsomming van bestandssysteemvermeldingen in de map die is opgegeven en path die overeenkomen met het opgegeven zoekpatroon en de opgegeven optie.
Uitzonderingen
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
– of –
searchPattern bevat geen geldig patroon.
searchOption is geen geldige SearchOption waarde.
path is ongeldig, zoals het verwijzen naar een niet-toegewezen station.
path is een bestandsnaam.
Het opgegeven pad, de bestandsnaam of de gecombineerde waarde overschrijdt de door het systeem gedefinieerde maximumlengte.
De beller heeft niet de vereiste machtiging.
De beller heeft niet de vereiste machtiging.
Opmerkingen
searchPattern kan een combinatie zijn van letterlijke tekens en jokertekens, maar biedt geen ondersteuning voor reguliere expressies. De volgende jokertekenaanduidingen zijn toegestaan in searchPattern.
| Jokertekenaanduiding | Overeenkomsten |
|---|---|
| * (sterretje) | Nul of meer tekens op die positie. |
| ? (vraagteken) | Precies één teken in die positie. |
Andere tekens dan het jokerteken zijn letterlijke tekens. Met de searchPattern tekenreeks '*t' wordt bijvoorbeeld gezocht naar alle namen die path eindigen op de letter 't'. De searchPattern tekenreeks 's*' zoekt naar alle namen in path het begin met de letter 's'.
Note
Wanneer u het jokerteken sterretje gebruikt in een searchPattern zoals '*.txt', is het aantal tekens in de opgegeven extensie als volgt van invloed op de zoekopdracht:
- Als de opgegeven extensie precies drie tekens lang is, retourneert de methode bestanden met extensies die beginnen met de opgegeven extensie. Bijvoorbeeld: '*.xls' retourneert zowel 'book.xls' als 'book.xlsx'.
- In alle andere gevallen retourneert de methode bestanden die exact overeenkomen met de opgegeven extensie. *.ai retourneert bijvoorbeeld 'file.ai' maar niet 'file.aif'.
Wanneer u het vraagteken jokerteken gebruikt, retourneert deze methode alleen bestanden die overeenkomen met de opgegeven bestandsextensie. Bijvoorbeeld, gegeven twee bestanden, 'file1.txt' en 'file1.txtother', in een map, een zoekpatroon van 'bestand?'.txt" retourneert alleen het eerste bestand, terwijl een zoekpatroon van 'bestand*.txt' beide bestanden retourneert.
searchPattern kan niet eindigen in twee perioden ("..") of twee punten ("."), gevolgd door DirectorySeparatorChar of AltDirectorySeparatorChar, noch mogen deze ongeldige tekens bevatten. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars methode.
U kunt relatieve padgegevens opgeven met de path parameter. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap, die u kunt bepalen met behulp van de GetCurrentDirectory methode.
De EnumerateFileSystemEntries en GetFileSystemEntries methoden verschillen als volgt: Wanneer u gebruikt EnumerateFileSystemEntries, kunt u beginnen met het inventariseren van de verzameling vermeldingen voordat de hele verzameling wordt geretourneerd. Wanneer u deze gebruikt GetFileSystemEntries, moet u wachten totdat de hele matrix met vermeldingen wordt geretourneerd voordat u toegang hebt tot de matrix. Daarom kan het efficiënter zijn wanneer u met veel bestanden en mappen EnumerateFileSystemEntries werkt.
De geretourneerde verzameling wordt niet in de cache opgeslagen; bij elke aanroep van de GetEnumerator verzameling wordt een nieuwe inventarisatie gestart.