Directory.EnumerateFileSystemEntries 메서드

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

지정된 조건을 충족하는 파일 시스템 항목의 열거 가능 컬렉션을 반환합니다.

오버로드

EnumerateFileSystemEntries(String)	지정된 경로에 있는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.
EnumerateFileSystemEntries(String, String)	지정된 경로에서 검색 패턴과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	지정된 경로에서 검색 패턴 및 열거형 옵션과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.
EnumerateFileSystemEntries(String, String, SearchOption)	지정된 경로에서 검색 패턴과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환하고 선택적으로 하위 디렉터리를 검색합니다.

EnumerateFileSystemEntries(String)

Source:

Directory.cs

지정된 경로에 있는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.

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)

매개 변수

path

String

검색할 디렉터리에 대한 상대 또는 절대 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

반환

IEnumerable<String>

path로 지정된 디렉터리에 있는 파일 시스템 항목의 열거 가능 컬렉션입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나 공백만 포함하거나 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브 참조).

IOException

path는 파일 이름입니다.

PathTooLongException

지정된 경로, 파일 이름 또는 이 둘의 조합이 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

호출자에게 필요한 권한이 없는 경우

설명

매개 변수를 path 사용하여 상대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 메서드를 사용하여 GetCurrentDirectory 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

및 메서드는 EnumerateFileSystemEntries 다음과 같이 다릅니다. 를 사용하면 EnumerateFileSystemEntries전체 컬렉션이 반환되기 전에 항목 컬렉션 열거를 시작할 수 있습니다. 를 사용하는 GetFileSystemEntries경우 배열에 액세스하기 전에 전체 항목 배열이 반환될 때까지 기다려야 GetFileSystemEntries 합니다. 따라서 많은 파일 및 디렉터리 EnumerateFileSystemEntries 로 작업할 때 보다 효율적일 수 있습니다.

반환된 컬렉션은 캐시되지 않습니다. 컬렉션에서 에 GetEnumerator 대한 각 호출은 새 열거형을 시작합니다.

EnumerateFileSystemEntries(String, String)

Source:

Directory.cs

지정된 경로에서 검색 패턴과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.

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)

매개 변수

path

String

검색할 디렉터리에 대한 상대 또는 절대 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

searchPattern

String

path에 있는 파일 시스템 항목 이름과 일치하는지 비교할 검색 문자열입니다. 이 매개 변수는 유효한 리터럴 경로와 와일드카드(* 및 ?) 문자로 된 조합을 포함하지만 정규식을 지원하지 않습니다.

반환

IEnumerable<String>

path로 지정된 디렉터리에서 지정된 검색 패턴과 일치하는 파일 시스템 항목의 열거 가능 컬렉션입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나 공백만 포함하거나 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

또는

searchPattern에 유효한 패턴이 포함되어 있지 않습니다.

ArgumentNullException

path이(가) null인 경우

또는

searchPattern이(가) null인 경우

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브 참조).

IOException

path는 파일 이름입니다.

PathTooLongException

지정된 경로, 파일 이름 또는 이 둘의 조합이 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

호출자에게 필요한 권한이 없는 경우

설명

searchPattern 는 리터럴 문자와 와일드카드 문자의 조합일 수 있지만 정규식을 지원하지는 않습니다. 에서 허용되는 와일드카드 지정자는 다음과 같습니다 searchPattern.

와일드카드 지정자	일치하는 항목
*(별표)	해당 위치에 0개 이상의 문자가 있습니다.
? (물음표)	해당 위치에 정확히 한 문자가 있습니다.

와일드카드 이외의 문자는 리터럴 문자입니다. 예를 들어 searchPattern 문자열 "*t"는 문자 "t"로 끝나는 의 모든 이름을 path 검색합니다. 문자열 "s*"는 searchPattern 문자 "s"로 path 시작하는 의 모든 이름을 검색합니다.

참고

"*.txt"과 같은 별표 와일드카드 문자를 searchPattern 사용하는 경우 지정된 확장의 문자 수는 다음과 같이 검색에 영향을 줍니다.

• 지정된 확장의 길이가 정확히 3자이면 메서드는 지정된 확장으로 시작하는 확장명을 가진 파일을 반환합니다. 예를 들어 "*.xls"은 "book.xls" 및 "book.xlsx"를 모두 반환합니다.
• 다른 모든 경우에서 메서드는 지정된 확장과 정확히 일치하는 파일을 반환합니다. 예를 들어 "*.ai"는 "file.ai"을 반환하지만 "file.aif"은 반환하지 않습니다.

물음표 와일드카드 문자를 사용하는 경우 이 메서드는 지정된 파일 확장명과 일치하는 파일만 반환합니다. 예를 들어 디렉터리에서 "file1.txt" 및 "file1.txtother"라는 두 개의 파일이 지정된 경우 "file?.txt"의 검색 패턴은 첫 번째 파일만 반환하는 반면 "file*.txt"의 검색 패턴은 두 파일을 모두 반환합니다.

searchPattern 는 두 개의 마침표("..")로 끝나거나 두 개의 마침표("..") 뒤에 DirectorySeparatorChar 또는 AltDirectorySeparatorChar를 포함할 수 없으며 잘못된 문자를 포함할 수도 없습니다. GetInvalidPathChars 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

매개 변수를 path 사용하여 상대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 메서드를 사용하여 GetCurrentDirectory 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

및 메서드는 EnumerateFileSystemEntries 다음과 같이 다릅니다. 를 사용하면 EnumerateFileSystemEntries전체 컬렉션이 반환되기 전에 항목 컬렉션 열거를 시작할 수 있습니다. 를 사용하는 GetFileSystemEntries경우 배열에 액세스하기 전에 전체 항목 배열이 반환될 때까지 기다려야 GetFileSystemEntries 합니다. 따라서 많은 파일 및 디렉터리 EnumerateFileSystemEntries 로 작업할 때 보다 효율적일 수 있습니다.

반환된 컬렉션은 캐시되지 않습니다. 컬렉션에서 에 GetEnumerator 대한 각 호출은 새 열거형을 시작합니다.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Source:

Directory.cs

지정된 경로에서 검색 패턴 및 열거형 옵션과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환합니다.

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)

매개 변수

path

String

검색할 디렉터리에 대한 상대 또는 절대 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

searchPattern

String

path에 있는 파일 및 디렉터리 이름과 일치하는지 비교할 검색 문자열입니다. 이 매개 변수는 유효한 리터럴 및 와일드카드 문자로 된 조합을 포함하지만 정규식을 지원하지 않습니다.

enumerationOptions

EnumerationOptions

사용할 검색 및 열거형 구성을 설명하는 개체입니다.

반환

IEnumerable<String>

path에서 지정된 디렉터리에 있고 지정된 검색 패턴 및 지정된 열거형 옵션과 일치하는 파일 시스템 항목의 열거 가능 컬렉션입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나 공백만 포함하거나 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

또는

searchPattern에 유효한 패턴이 포함되어 있지 않습니다.

ArgumentNullException

path이(가) null인 경우

또는

searchPattern은 null입니다.

ArgumentOutOfRangeException

searchOption는 유효한 SearchOption 값이 아닙니다.

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브 참조).

IOException

path는 파일 이름입니다.

PathTooLongException

지정된 경로, 파일 이름 또는 이 둘의 조합이 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

호출자에게 필요한 권한이 없는 경우

설명

searchPattern 는 리터럴 문자와 와일드카드 문자의 조합일 수 있지만 정규식을 지원하지는 않습니다. 에서 허용되는 와일드카드 지정자는 다음과 같습니다 searchPattern.

와일드카드 지정자	일치하는 항목
*(별표)	해당 위치에 0개 이상의 문자가 있습니다.
? (물음표)	해당 위치에 정확히 한 문자가 있습니다.

와일드카드 이외의 문자는 리터럴 문자입니다. 예를 들어 searchPattern 문자열 "*t"는 문자 "t"로 끝나는 의 모든 이름을 path 검색합니다. 문자열 "s*"는 searchPattern 문자 "s"로 path 시작하는 의 모든 이름을 검색합니다.

참고

"*.txt"과 같은 별표 와일드카드 문자를 searchPattern 사용하는 경우 지정된 확장의 문자 수는 다음과 같이 검색에 영향을 줍니다.

• 지정된 확장의 길이가 정확히 3자이면 메서드는 지정된 확장으로 시작하는 확장명을 가진 파일을 반환합니다. 예를 들어 "*.xls"은 "book.xls" 및 "book.xlsx"를 모두 반환합니다.
• 다른 모든 경우에서 메서드는 지정된 확장과 정확히 일치하는 파일을 반환합니다. 예를 들어 "*.ai"는 "file.ai"을 반환하지만 "file.aif"은 반환하지 않습니다.

물음표 와일드카드 문자를 사용하는 경우 이 메서드는 지정된 파일 확장명과 일치하는 파일만 반환합니다. 예를 들어 디렉터리에서 "file1.txt" 및 "file1.txtother"라는 두 개의 파일이 지정된 경우 "file?.txt"의 검색 패턴은 첫 번째 파일만 반환하는 반면 "file*.txt"의 검색 패턴은 두 파일을 모두 반환합니다.

searchPattern 는 두 개의 마침표("..")로 끝나거나 두 개의 마침표("..") 뒤에 DirectorySeparatorChar 또는 AltDirectorySeparatorChar를 포함할 수 없으며 잘못된 문자를 포함할 수도 없습니다. GetInvalidPathChars 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

매개 변수를 path 사용하여 상대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 메서드를 사용하여 GetCurrentDirectory 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

및 메서드는 EnumerateFileSystemEntries 다음과 같이 다릅니다. 를 사용하면 EnumerateFileSystemEntries전체 컬렉션이 반환되기 전에 항목 컬렉션 열거를 시작할 수 있습니다. 를 사용하는 GetFileSystemEntries경우 배열에 액세스하기 전에 전체 항목 배열이 반환될 때까지 기다려야 GetFileSystemEntries 합니다. 따라서 많은 파일 및 디렉터리 EnumerateFileSystemEntries 로 작업할 때 보다 효율적일 수 있습니다.

반환된 컬렉션은 캐시되지 않습니다. 컬렉션에서 에 GetEnumerator 대한 각 호출은 새 열거형을 시작합니다.

EnumerateFileSystemEntries(String, String, SearchOption)

Source:

Directory.cs

지정된 경로에서 검색 패턴과 일치하는 파일 이름 및 디렉터리 이름의 열거 가능 컬렉션을 반환하고 선택적으로 하위 디렉터리를 검색합니다.

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)

매개 변수

path

String

검색할 디렉터리에 대한 상대 또는 절대 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

searchPattern

String

path에 있는 파일 시스템 항목과 일치하는지 비교할 검색 문자열입니다. 이 매개 변수는 유효한 리터럴 경로와 와일드카드(* 및 ?) 문자로 된 조합을 포함하지만 정규식을 지원하지 않습니다.

searchOption

SearchOption

검색 작업에 현재 디렉터리만 포함할지 아니면 모든 하위 디렉터리를 포함할지를 지정하는 열거형 값 중 하나입니다. 기본값은 TopDirectoryOnly입니다.

반환

IEnumerable<String>

path로 지정된 디렉터리에서 지정된 검색 패턴 및 옵션과 일치하는 파일 시스템 항목의 열거 가능 컬렉션입니다.

예외

ArgumentException

2.1보다 오래된 .NET Framework 및 .NET Core 버전: path 길이가 0인 문자열이거나 공백만 포함하거나 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

또는

searchPattern에 유효한 패턴이 포함되어 있지 않습니다.

ArgumentNullException

path이(가) null인 경우

또는

searchPattern은 null입니다.

ArgumentOutOfRangeException

searchOption는 유효한 SearchOption 값이 아닙니다.

DirectoryNotFoundException

path가 잘못되었습니다(예: 매핑되지 않은 드라이브 참조).

IOException

path는 파일 이름입니다.

PathTooLongException

지정된 경로, 파일 이름 또는 이 둘의 조합이 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

호출자에게 필요한 권한이 없는 경우

설명

searchPattern 는 리터럴 문자와 와일드카드 문자의 조합일 수 있지만 정규식을 지원하지는 않습니다. 에서 허용되는 와일드카드 지정자는 다음과 같습니다 searchPattern.

와일드카드 지정자	일치하는 항목
*(별표)	해당 위치에 0개 이상의 문자가 있습니다.
? (물음표)	해당 위치에 정확히 한 문자가 있습니다.

와일드카드 이외의 문자는 리터럴 문자입니다. 예를 들어 searchPattern 문자열 "*t"는 문자 "t"로 끝나는 의 모든 이름을 path 검색합니다. 문자열 "s*"는 searchPattern 문자 "s"로 path 시작하는 의 모든 이름을 검색합니다.

참고

"*.txt"과 같은 별표 와일드카드 문자를 searchPattern 사용하는 경우 지정된 확장의 문자 수는 다음과 같이 검색에 영향을 줍니다.

• 지정된 확장의 길이가 정확히 3자이면 메서드는 지정된 확장으로 시작하는 확장명을 가진 파일을 반환합니다. 예를 들어 "*.xls"은 "book.xls" 및 "book.xlsx"를 모두 반환합니다.
• 다른 모든 경우에서 메서드는 지정된 확장과 정확히 일치하는 파일을 반환합니다. 예를 들어 "*.ai"는 "file.ai"을 반환하지만 "file.aif"은 반환하지 않습니다.

물음표 와일드카드 문자를 사용하는 경우 이 메서드는 지정된 파일 확장명과 일치하는 파일만 반환합니다. 예를 들어 디렉터리에서 "file1.txt" 및 "file1.txtother"라는 두 개의 파일이 지정된 경우 "file?.txt"의 검색 패턴은 첫 번째 파일만 반환하는 반면 "file*.txt"의 검색 패턴은 두 파일을 모두 반환합니다.

searchPattern 는 두 개의 마침표("..")로 끝나거나 두 개의 마침표("..") 뒤에 DirectorySeparatorChar 또는 AltDirectorySeparatorChar를 포함할 수 없으며 잘못된 문자를 포함할 수도 없습니다. GetInvalidPathChars 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

매개 변수를 path 사용하여 상대 경로 정보를 지정할 수 있습니다. 상대 경로 정보는 메서드를 사용하여 GetCurrentDirectory 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

및 메서드는 EnumerateFileSystemEntries 다음과 같이 다릅니다. 를 사용하면 EnumerateFileSystemEntries전체 컬렉션이 반환되기 전에 항목 컬렉션 열거를 시작할 수 있습니다. 를 사용하는 GetFileSystemEntries경우 배열에 액세스하기 전에 전체 항목 배열이 반환될 때까지 기다려야 GetFileSystemEntries 합니다. 따라서 많은 파일 및 디렉터리 EnumerateFileSystemEntries 로 작업할 때 보다 효율적일 수 있습니다.

반환된 컬렉션은 캐시되지 않습니다. 컬렉션에서 에 GetEnumerator 대한 각 호출은 새 열거형을 시작합니다.