FileSystem.GetFiles 메서드

정의

네임스페이스:

Microsoft.VisualBasic.FileIO

어셈블리:

Microsoft.VisualBasic.Core.dll

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

오버로드

GetFiles(String)	디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.
GetFiles(String, SearchOption, String[])	디렉터리에 있는 파일 이름을 나타내는 문자열의 읽기 전용 컬렉션을 반환합니다.

GetFiles(String)

Source:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

매개 변수

directory

String

검색할 디렉터리입니다.

반환

ReadOnlyCollection<String>

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

예외

ArgumentException

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

ArgumentNullException

directory이(가) Nothing인 경우

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

예제

다음 예제에서는 디렉터리의 모든 파일을 반환하여 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 메서드.

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

추가 정보

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Source:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

매개 변수

directory

String

검색할 디렉터리입니다.

searchType

SearchOption

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

wildcards

String[]

일치할 패턴입니다.

반환

ReadOnlyCollection<String>

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

예외

ArgumentException

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

ArgumentNullException

directory이(가) Nothing인 경우

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

예제

다음 예제에서는 디렉터리의 모든 파일을 반환하여 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 메서드.

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

추가 정보

• SearchOption
• ReadOnlyCollection<T>