Directory.EnumerateFileSystemEntries 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 조건을 충족하는 파일 시스템 항목의 열거 가능한 컬렉션을 반환합니다.
오버로드
| 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() 수 있습니다.
path은 null입니다.
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 은 유효한 패턴을 포함하지 않습니다.
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 은 유효한 패턴을 포함하지 않습니다.
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 은 유효한 패턴을 포함하지 않습니다.
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 각 호출은 새 열거형을 시작합니다.