다음을 통해 공유


FileSystemProxy.GetFiles 메서드

정의

디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

오버로드

GetFiles(String, SearchOption, String[])

디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

GetFiles(String)

디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

GetFiles(String, SearchOption, String[])

디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

매개 변수

directory
String

검색할 디렉터리입니다.

searchType
SearchOption

하위 폴더를 포함할지 여부입니다. 기본값은 SearchOption.SearchTopLevelOnly입니다.

wildcards
String[]

일치할 패턴입니다.

반환

지정된 디렉터리에 있는 파일 이름의 읽기 전용 컬렉션입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

directory이(가) Nothing인 경우

검색할 디렉터리가 없습니다.

directory가 기존 파일을 가리키는 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

사용자에게 필요한 권한이 없는 경우

예제

다음 예제에서는 디렉터리의 모든 파일을 반환하여 ListBox1에 추가합니다.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

이 예제에서는 ListBox 양식에 라는 가 ListBox1 있어야 합니다.

이 예제에서는 확장 .txt 명과 함께 디렉터리의 모든 파일을 반환하고 에 ListBox1추가합니다.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

이 예제에서는 ListBox 양식에 라는 가 ListBox1 있어야 합니다.

설명

지정한 패턴과 일치하는 파일이 없으면 빈 컬렉션이 반환됩니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.GetFiles 메서드.

대상 참조 항목
디렉터리에서 파일 컬렉션 가져오기 방법: 디렉터리의 파일 컬렉션 가져오기
디렉터리에서 특정 패턴의 파일 찾기 방법: 특정 패턴의 파일 찾기

추가 정보

적용 대상

GetFiles(String)

디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

매개 변수

directory
String

검색할 디렉터리입니다.

반환

지정된 디렉터리에 있는 파일 이름의 읽기 전용 컬렉션입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

directory이(가) Nothing인 경우

검색할 디렉터리가 없습니다.

directory가 기존 파일을 가리키는 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

사용자에게 필요한 권한이 없는 경우

예제

다음 예제에서는 디렉터리의 모든 파일을 반환하여 ListBox1에 추가합니다.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

이 예제에서는 ListBox 양식에 라는 가 ListBox1 있어야 합니다.

이 예제에서는 확장 .txt 명과 함께 디렉터리의 모든 파일을 반환하고 에 ListBox1추가합니다.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

이 예제에서는 ListBox 양식에 라는 가 ListBox1 있어야 합니다.

설명

지정한 패턴과 일치하는 파일이 없으면 빈 컬렉션이 반환됩니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.GetFiles 메서드.

대상 참조 항목
디렉터리에서 파일 컬렉션 가져오기 방법: 디렉터리의 파일 컬렉션 가져오기
디렉터리에서 특정 패턴의 파일 찾기 방법: 특정 패턴의 파일 찾기

추가 정보

적용 대상