Directory.EnumerateFileSystemEntries 메서드

정의

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

오버로드

Name Description
EnumerateFileSystemEntries(String)

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

EnumerateFileSystemEntries(String, String)

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

EnumerateFileSystemEntries(String, String, EnumerationOptions)

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

EnumerateFileSystemEntries(String, String, SearchOption)

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

EnumerateFileSystemEntries(String)

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

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

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

반품

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

예외

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

pathnull입니다.

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

path 은 파일 이름입니다.

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

호출자에게 필요한 권한이 없습니다.

호출자에게 필요한 권한이 없습니다.

설명

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

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

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

적용 대상

EnumerateFileSystemEntries(String, String)

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

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. 이 매개 변수는 유효한 리터럴 경로와 와일드카드(* 및 ?) 문자의 조합을 포함할 수 있지만 정규식을 지원하지는 않습니다.

반품

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

예외

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

-또는-

searchPattern 은 유효한 패턴을 포함하지 않습니다.

pathnull입니다.

-또는-

searchPatternnull입니다.

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

path 은 파일 이름입니다.

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

호출자에게 필요한 권한이 없습니다.

호출자에게 필요한 권한이 없습니다.

설명

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 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

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

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

적용 대상

EnumerateFileSystemEntries(String, String, EnumerationOptions)

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

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

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

반품

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

예외

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

-또는-

searchPattern 은 유효한 패턴을 포함하지 않습니다.

pathnull입니다.

-또는-

searchPatternnull입니다.

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

path 은 파일 이름입니다.

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

호출자에게 필요한 권한이 없습니다.

호출자에게 필요한 권한이 없습니다.

설명

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 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

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

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

적용 대상

EnumerateFileSystemEntries(String, String, SearchOption)

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

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입니다.

반품

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

예외

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

-또는-

searchPattern 은 유효한 패턴을 포함하지 않습니다.

pathnull입니다.

-또는-

searchPatternnull입니다.

searchOption 가 유효한 SearchOption 값이 아닌 경우

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

path 은 파일 이름입니다.

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

호출자에게 필요한 권한이 없습니다.

호출자에게 필요한 권한이 없습니다.

설명

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 확인할 수 있는 현재 작업 디렉터리를 기준으로 해석됩니다.

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

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

적용 대상