My.Computer.FileSystem.GetDirectories 메서드

아티클
08/20/2008

업데이트: 2007년 11월

디렉터리 내에 있는 하위 디렉터리의 경로 이름을 나타내는 문자열의 컬렉션을 반환합니다.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

매개 변수

directory
필수적 요소이며 String 형식입니다. 디렉터리의 이름 및 경로입니다.
searchType
SearchOption 열거형이며 하위 폴더를 포함할지 여부를 나타냅니다. 기본값은 SearchOption.SearchTopLevelOnly이며 필수적 요소입니다.
wildcards
필수적 요소이며 String 형식입니다. 이름과 일치할 패턴입니다.

반환 값

String 형식의 읽기 전용 컬렉션입니다.

예외

다음 조건에서 예외가 발생할 수 있습니다.

길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, \\.\로 시작하는 장치 경로와 같은 여러 가지 이유 중 하나로 경로가 올바르지 않은 경우(ArgumentException)
경로가 Nothing이기 때문에 올바르지 않은 경우(ArgumentNullException)
지정한 와일드카드 문자 중 하나 이상이 Nothing이거나, 빈 문자열이거나 공백만 포함하는 경우(ArgumentNullException)
directory가 없는 경우(DirectoryNotFoundException)
directory가 기존 파일을 가리키는 경우(IOException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우(NotSupportedException)
경로를 보는 데 필요한 권한이 사용자에게 없는 경우(SecurityException)
사용자에게 필요한 권한이 없는 경우(UnauthorizedAccessException)

설명

wildcards 매개 변수를 사용하여 특정 패턴을 지정할 수 있습니다. 하위 디렉터리의 내용을 검색에 포함하려는 경우 searchType 매개 변수를 SearchAllSubDirectories로 설정합니다.

지정한 패턴과 일치하는 디렉터리가 없는 경우 빈 컬렉션이 반환됩니다.

작업

다음 표에서는 My.Computer.FileSystem.GetDirectories 메서드와 관련된 작업의 예를 보여 줍니다.

작업	참조
특정 패턴을 갖는 하위 디렉터리 나열	방법: Visual Basic에서 특정 패턴의 하위 디렉터리 찾기

예제

다음 예제는 이름에 Logs 라는 단어가 있는 디렉터리 구조의 모든 디렉터리를 반환하여 ListBox1에 추가합니다.

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

이 예제가 제대로 실행되려면 폼에 이름이 ListBox1인 ListBox가 있어야 합니다.

요구 사항

네임스페이스:Microsoft.VisualBasic.MyServices

클래스:FileSystemProxy(FileSystem에 대한 액세스 제공)

어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted

자세한 내용은 코드 액세스 보안 및 권한 요청을 참조하십시오.

참고 항목

참조

My.Computer.FileSystem 개체

SearchOption 열거형

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetDirectories

다음을 통해 공유