Directory.EnumerateFileSystemEntries Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Returnerar en uppräkningsbar samling filsystemposter som uppfyller angivna villkor.
Överlagringar
| Name | Description |
|---|---|
| EnumerateFileSystemEntries(String) |
Returnerar en uppräkningsbar samling filnamn och katalognamn i en angiven sökväg. |
| EnumerateFileSystemEntries(String, String) |
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster i en angiven sökväg. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster och uppräkningsalternativ i en angiven sökväg. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster i en angiven sökväg och söker eventuellt i underkataloger. |
EnumerateFileSystemEntries(String)
Returnerar en uppräkningsbar samling filnamn och katalognamn i en angiven sökväg.
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)Parametrar
- path
- String
Den relativa eller absoluta sökvägen till katalogen som ska sökas. Den här strängen är inte skiftlägeskänslig.
Returer
En uppräkningsbar samling filsystemposter i katalogen som anges av path.
Undantag
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
path är null.
path är ogiltigt, till exempel refererar till en ommappad enhet.
path är ett filnamn.
Den angivna sökvägen, filnamnet eller kombinerade överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Anroparen har inte den behörighet som krävs.
Kommentarer
Du kan ange relativ sökvägsinformation med parametern path . Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen, vilket du kan avgöra med hjälp GetCurrentDirectory av metoden.
Metoderna EnumerateFileSystemEntries och GetFileSystemEntries skiljer sig åt på följande sätt: När du använder EnumerateFileSystemEntrieskan du börja räkna upp samlingen med poster innan hela samlingen returneras. När du använder GetFileSystemEntriesmåste du vänta tills hela matrisen med poster returneras innan du kan komma åt matrisen. Därför kan det vara mer effektivt när du arbetar med många filer och kataloger EnumerateFileSystemEntries .
Den returnerade samlingen cachelagras inte. varje anrop till GetEnumerator i samlingen startar en ny uppräkning.
Gäller för
EnumerateFileSystemEntries(String, String)
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster i en angiven sökväg.
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)Parametrar
- path
- String
Den relativa eller absoluta sökvägen till katalogen som ska sökas. Den här strängen är inte skiftlägeskänslig.
- searchPattern
- String
Söksträngen som ska matchas mot namnen på filsystemposterna i path. Den här parametern kan innehålla en kombination av giltiga teckensökväg och jokertecken (* och ?), men den stöder inte reguljära uttryck.
Returer
En uppräkningsbar samling av filsystemposter i katalogen som anges av path och som matchar det angivna sökmönstret.
Undantag
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
-eller-
searchPattern innehåller inget giltigt mönster.
path är ogiltigt, till exempel refererar till en ommappad enhet.
path är ett filnamn.
Den angivna sökvägen, filnamnet eller kombinerade överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Anroparen har inte den behörighet som krävs.
Kommentarer
searchPattern kan vara en kombination av literaltecken och jokertecken, men det stöder inte reguljära uttryck. Följande jokerteckensspecificerare tillåts i searchPattern.
| Jokerteckensspecificerare | Matcher |
|---|---|
| * (asterisk) | Noll eller fler tecken i den positionen. |
| ? (frågetecken) | Exakt ett tecken i den positionen. |
Andra tecken än jokertecknet är literaltecken. Strängen searchPattern "*t" söker till exempel efter alla namn som path slutar med bokstaven "t". Strängen searchPattern "s*" söker efter alla namn från path och med bokstaven "s".
Note
När du använder jokertecknet asterisk i till searchPattern exempel "*.txt" påverkar antalet tecken i det angivna tillägget sökningen enligt följande:
- Om det angivna tillägget är exakt tre tecken långt returnerar metoden filer med tillägg som börjar med det angivna tillägget. Till exempel returnerar "*.xls" både "book.xls" och "book.xlsx".
- I alla andra fall returnerar metoden filer som exakt matchar det angivna tillägget. Till exempel returnerar "*.ai" "file.ai" men inte "file.aif".
När du använder jokertecknet frågetecken returnerar den här metoden endast filer som matchar det angivna filtillägget. Till exempel med två filer, "file1.txt" och "file1.txtother", i en katalog, ett sökmönster för "fil?.txtreturnerar bara den första filen, medan ett sökmönster med "file*.txt" returnerar båda filerna.
searchPattern kan inte sluta i två perioder ("..") eller innehålla två punkter ("..") följt av DirectorySeparatorChar eller AltDirectorySeparatorChar, och kan inte heller innehålla ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars av metoden .
Du kan ange relativ sökvägsinformation med parametern path . Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen, vilket du kan avgöra med hjälp GetCurrentDirectory av metoden.
Metoderna EnumerateFileSystemEntries och GetFileSystemEntries skiljer sig åt på följande sätt: När du använder EnumerateFileSystemEntrieskan du börja räkna upp samlingen med poster innan hela samlingen returneras. När du använder GetFileSystemEntriesmåste du vänta tills hela matrisen med poster returneras innan du kan komma åt matrisen. Därför kan det vara mer effektivt när du arbetar med många filer och kataloger EnumerateFileSystemEntries .
Den returnerade samlingen cachelagras inte. varje anrop till GetEnumerator i samlingen startar en ny uppräkning.
Gäller för
EnumerateFileSystemEntries(String, String, EnumerationOptions)
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster och uppräkningsalternativ i en angiven sökväg.
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)Parametrar
- path
- String
Den relativa eller absoluta sökvägen till katalogen som ska sökas. Den här strängen är inte skiftlägeskänslig.
- searchPattern
- String
Söksträngen som ska matchas mot namnen på filer och kataloger i path. Den här parametern kan innehålla en kombination av giltiga literaltecken och jokertecken, men den stöder inte reguljära uttryck.
- enumerationOptions
- EnumerationOptions
Ett objekt som beskriver den sök- och uppräkningskonfiguration som ska användas.
Returer
En uppräkningsbar samling filsystemposter i katalogen som anges av path, som matchar det angivna sökmönstret och de angivna uppräkningsalternativen.
Undantag
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
-eller-
searchPattern innehåller inget giltigt mönster.
path är ogiltigt, till exempel refererar till en ommappad enhet.
path är ett filnamn.
Den angivna sökvägen, filnamnet eller kombinerade överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Anroparen har inte den behörighet som krävs.
Kommentarer
searchPattern kan vara en kombination av literaltecken och jokertecken, men det stöder inte reguljära uttryck. Följande jokerteckensspecificerare tillåts i searchPattern.
| Jokerteckensspecificerare | Matcher |
|---|---|
| * (asterisk) | Noll eller fler tecken i den positionen. |
| ? (frågetecken) | Exakt ett tecken i den positionen. |
Andra tecken än jokertecknet är literaltecken. Strängen searchPattern "*t" söker till exempel efter alla namn som path slutar med bokstaven "t". Strängen searchPattern "s*" söker efter alla namn från path och med bokstaven "s".
Note
När du använder jokertecknet asterisk i till searchPattern exempel "*.txt" påverkar antalet tecken i det angivna tillägget sökningen enligt följande:
- Om det angivna tillägget är exakt tre tecken långt returnerar metoden filer med tillägg som börjar med det angivna tillägget. Till exempel returnerar "*.xls" både "book.xls" och "book.xlsx".
- I alla andra fall returnerar metoden filer som exakt matchar det angivna tillägget. Till exempel returnerar "*.ai" "file.ai" men inte "file.aif".
När du använder jokertecknet frågetecken returnerar den här metoden endast filer som matchar det angivna filtillägget. Till exempel med två filer, "file1.txt" och "file1.txtother", i en katalog, ett sökmönster för "fil?.txtreturnerar bara den första filen, medan ett sökmönster med "file*.txt" returnerar båda filerna.
searchPattern kan inte sluta i två perioder ("..") eller innehålla två punkter ("..") följt av DirectorySeparatorChar eller AltDirectorySeparatorChar, och kan inte heller innehålla ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars av metoden .
Du kan ange relativ sökvägsinformation med parametern path . Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen, vilket du kan avgöra med hjälp GetCurrentDirectory av metoden.
Metoderna EnumerateFileSystemEntries och GetFileSystemEntries skiljer sig åt på följande sätt: När du använder EnumerateFileSystemEntrieskan du börja räkna upp samlingen med poster innan hela samlingen returneras. När du använder GetFileSystemEntriesmåste du vänta tills hela matrisen med poster returneras innan du kan komma åt matrisen. Därför kan det vara mer effektivt när du arbetar med många filer och kataloger EnumerateFileSystemEntries .
Den returnerade samlingen cachelagras inte. varje anrop till GetEnumerator i samlingen startar en ny uppräkning.
Gäller för
EnumerateFileSystemEntries(String, String, SearchOption)
Returnerar en uppräkningsbar samling filnamn och katalognamn som matchar ett sökmönster i en angiven sökväg och söker eventuellt i underkataloger.
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)Parametrar
- path
- String
Den relativa eller absoluta sökvägen till katalogen som ska sökas. Den här strängen är inte skiftlägeskänslig.
- searchPattern
- String
Söksträngen som ska matchas mot filsystemposter i path. Den här parametern kan innehålla en kombination av giltiga teckensökväg och jokertecken (* och ?), men den stöder inte reguljära uttryck.
- searchOption
- SearchOption
Ett av uppräkningsvärdena som anger om sökåtgärden endast ska innehålla den aktuella katalogen eller ska innehålla alla underkataloger. Standardvärdet är TopDirectoryOnly.
Returer
En uppräkningsbar samling filsystemposter i katalogen som anges av path och som matchar det angivna sökmönstret och alternativet.
Undantag
.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .
-eller-
searchPattern innehåller inget giltigt mönster.
searchOption är inte ett giltigt SearchOption värde.
path är ogiltigt, till exempel refererar till en ommappad enhet.
path är ett filnamn.
Den angivna sökvägen, filnamnet eller kombinerade överskrider den systemdefinierade maximala längden.
Anroparen har inte den behörighet som krävs.
Anroparen har inte den behörighet som krävs.
Kommentarer
searchPattern kan vara en kombination av literaltecken och jokertecken, men det stöder inte reguljära uttryck. Följande jokerteckensspecificerare tillåts i searchPattern.
| Jokerteckensspecificerare | Matcher |
|---|---|
| * (asterisk) | Noll eller fler tecken i den positionen. |
| ? (frågetecken) | Exakt ett tecken i den positionen. |
Andra tecken än jokertecknet är literaltecken. Strängen searchPattern "*t" söker till exempel efter alla namn som path slutar med bokstaven "t". Strängen searchPattern "s*" söker efter alla namn från path och med bokstaven "s".
Note
När du använder jokertecknet asterisk i till searchPattern exempel "*.txt" påverkar antalet tecken i det angivna tillägget sökningen enligt följande:
- Om det angivna tillägget är exakt tre tecken långt returnerar metoden filer med tillägg som börjar med det angivna tillägget. Till exempel returnerar "*.xls" både "book.xls" och "book.xlsx".
- I alla andra fall returnerar metoden filer som exakt matchar det angivna tillägget. Till exempel returnerar "*.ai" "file.ai" men inte "file.aif".
När du använder jokertecknet frågetecken returnerar den här metoden endast filer som matchar det angivna filtillägget. Till exempel med två filer, "file1.txt" och "file1.txtother", i en katalog, ett sökmönster för "fil?.txtreturnerar bara den första filen, medan ett sökmönster med "file*.txt" returnerar båda filerna.
searchPattern kan inte sluta i två perioder ("..") eller innehålla två punkter ("..") följt av DirectorySeparatorChar eller AltDirectorySeparatorChar, och kan inte heller innehålla ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars av metoden .
Du kan ange relativ sökvägsinformation med parametern path . Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen, vilket du kan avgöra med hjälp GetCurrentDirectory av metoden.
Metoderna EnumerateFileSystemEntries och GetFileSystemEntries skiljer sig åt på följande sätt: När du använder EnumerateFileSystemEntrieskan du börja räkna upp samlingen med poster innan hela samlingen returneras. När du använder GetFileSystemEntriesmåste du vänta tills hela matrisen med poster returneras innan du kan komma åt matrisen. Därför kan det vara mer effektivt när du arbetar med många filer och kataloger EnumerateFileSystemEntries .
Den returnerade samlingen cachelagras inte. varje anrop till GetEnumerator i samlingen startar en ny uppräkning.