My.Computer.FileSystem.FindInFiles 메서드

아티클
08/20/2008

업데이트: 2007년 11월

지정된 텍스트가 포함된 파일의 이름을 나타내는 읽기 전용 문자열 컬렉션을 반환합니다.

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

매개 변수

Directory
String 형식이며 검색할 디렉터리입니다. 필수적 요소입니다.
containsText
String 형식이며 검색 텍스트입니다. 필수적 요소입니다.
ignoreCase
Boolean 형식이며 검색에서 대/소문자를 구분할지 여부를 지정합니다. 기본값은 True이며 필수적 요소입니다.
searchType
SearchOption 열거형 형식이며 하위 폴더를 포함할지 여부를 지정합니다. 기본값은 SearchOption.SearchTopLevelOnly이며 필수적 요소입니다.
fileWildcards
String 형식의 배열입니다. 일치하는 패턴입니다. 필수적 요소입니다.

반환 값

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

예외

다음 조건에서 예외가 발생합니다.

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

설명

지정된 패턴과 일치하는 파일이 없는 경우 빈 컬렉션이 반환됩니다.

작업

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

작업	참조
특정 문자열을 포함하는 파일의 디렉터리 검색	연습: Visual Basic에서 파일과 디렉터리 조작

예제

이 예제에서는 "sample string" 문자열을 포함하는 파일을 찾기 위해 C:\TestDir 디렉터리를 검색하고 결과를 ListBox1에 표시합니다.

Dim list As System.Collections.ObjectModel.ReadOnlyCollection _
(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", _
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name As String In list
    ListBox1.Items.Add(name)
Next

이 예제를 실행하려면 프로젝트에 ListBox1이라는 ListBox를 포함해야 합니다.

요구 사항

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

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

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

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

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