FileSystem.Dir 메서드

정의

네임스페이스:

Microsoft.VisualBasic

어셈블리:

Microsoft.VisualBasic.Core.dll

지정한 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블을 반환합니다. FileSystem을 사용하면 Dir 함수를 사용할 때보다 파일 I/O 작업의 생산성 및 성능이 향상됩니다. 자세한 내용은 GetDirectoryInfo(String)를 참조하세요.

오버로드

Dir()	지정한 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블을 반환합니다. FileSystem을 사용하면 Dir 함수를 사용할 때보다 파일 I/O 작업의 생산성 및 성능이 향상됩니다. 자세한 내용은 GetDirectoryInfo(String)를 참조하세요.
Dir(String, FileAttribute)	지정한 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블을 반환합니다. FileSystem을 사용하면 Dir 함수를 사용할 때보다 파일 I/O 작업의 생산성 및 성능이 향상됩니다. 자세한 내용은 GetDirectoryInfo(String)를 참조하세요.

Dir()

Source:

FileSystem.vb

지정한 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블을 반환합니다. FileSystem을 사용하면 Dir 함수를 사용할 때보다 파일 I/O 작업의 생산성 및 성능이 향상됩니다. 자세한 내용은 GetDirectoryInfo(String)를 참조하세요.

public:
 static System::String ^ Dir();

public static string Dir ();

static member Dir : unit -> string

Public Function Dir () As String

반환

String

지정된 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블입니다.

예제

이 예제에서는 함수를 Dir 사용하여 특정 파일 및 디렉터리 존재 여부를 확인합니다.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")

' Returns filename with specified extension. If more than one *.INI
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")

' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir()

' Return first *.TXT file, including files with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)

' Display the names in C:\ that represent directories.
MyPath = "c:\"   ' Set the path.
MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
Do While MyName <> ""   ' Start the loop.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

설명

함수는 Dir 다중 문자() 및 단일 문자(*?) 와일드카드를 사용하여 여러 파일을 지정할 수 있도록 지원합니다.

VbVolume 는 특정 파일 이름 대신 드라이브의 볼륨 레이블을 반환합니다.

함수를 PathName 처음 호출 Dir 할 때 를 제공해야 합니다. 다음 항목을 검색하려면 매개 변수 없이 함수를 Dir 후속 호출할 수 있습니다.

중요

올바르게 실행하려면 함수 Read 에서 Dir 의 및 PathDiscovery 플래그 FileIOPermission 를 실행 코드에 부여해야 합니다. 자세한 내용은 , SecurityException및 코드 액세스 권한을 참조FileIOPermission하세요.

Attributes 인수 열거형 값은 다음과 같습니다.

값	상수	설명
Normal	vbnormal	기본값 특성이 없는 파일을 지정합니다.
ReadOnly	vbReadOnly	읽기 전용 파일 및 특성이 없는 파일도 지정합니다.
Hidden	vbHidden	숨겨진 파일 및 특성이 없는 파일도 지정합니다.
System	vbSystem	시스템 파일 및 특성이 없는 파일도 지정합니다.
Volume	vbVolume	볼륨 레이블을 지정합니다. 다른 특성이 지정되면 vbVolume 는 무시됩니다.
Directory	vbDirectory	디렉터리 또는 폴더 및 특성이 없는 파일도 지정합니다.
Archive	vbArchive	마지막 백업 이후에 파일이 변경되었습니다.
Alias	vbAlias	파일에 다른 이름이 있습니다.

참고

이러한 열거형은 Visual Basic 언어로 지정되며 실제 값 대신 코드의 아무 곳에서나 사용할 수 있습니다.

추가 정보

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

Source:

FileSystem.vb

지정한 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블을 반환합니다. FileSystem을 사용하면 Dir 함수를 사용할 때보다 파일 I/O 작업의 생산성 및 성능이 향상됩니다. 자세한 내용은 GetDirectoryInfo(String)를 참조하세요.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string

Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

매개 변수

PathName

String

선택 사항입니다. 파일 이름, 디렉터리나 폴더 이름 또는 드라이브 볼륨 레이블을 지정하는 문자열 식입니다. PathName이 없으면 길이가 0인 문자열("")이 반환됩니다.

Attributes

FileAttribute

선택 사항입니다. 파일 특성을 지정하는 값을 가진 열거형 또는 숫자 식입니다. 이 매개 변수를 생략하면 Dir는 Pathname과 일치하지만 특성이 없는 파일을 반환합니다.

반환

String

지정된 패턴이나 파일 특성과 일치하는 파일, 디렉터리 또는 폴더의 이름을 나타내는 문자열 또는 드라이브의 볼륨 레이블입니다.

특성

SupportedOSPlatformAttribute

예제

이 예제에서는 함수를 Dir 사용하여 특정 파일 및 디렉터리 존재 여부를 확인합니다.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")

' Returns filename with specified extension. If more than one *.INI
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")

' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir()

' Return first *.TXT file, including files with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)

' Display the names in C:\ that represent directories.
MyPath = "c:\"   ' Set the path.
MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
Do While MyName <> ""   ' Start the loop.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

설명

함수는 Dir 다중 문자() 및 단일 문자(*?) 와일드카드를 사용하여 여러 파일을 지정할 수 있도록 지원합니다.
VbVolume 는 특정 파일 이름 대신 드라이브의 볼륨 레이블을 반환합니다.
함수를 PathName 처음 호출 Dir 할 때 를 제공해야 합니다. 다음 항목을 검색하려면 매개 변수 없이 함수를 Dir 후속 호출할 수 있습니다.

중요

올바르게 실행하려면 함수 Read 에서 Dir 의 및 PathDiscovery 플래그 FileIOPermission 를 실행 코드에 부여해야 합니다. 자세한 내용은 , SecurityException및 코드 액세스 권한을 참조FileIOPermission하세요.
Attributes 인수 열거형 값은 다음과 같습니다.
|값|상수|설명|
|-|-|-|
| Normal | vbnormal|기본. 특성이 없는 파일을 지정합니다.|
| ReadOnly | vbReadOnly|특성이 없는 파일 외에도 읽기 전용 파일을 지정합니다.|
| Hidden | vbHidden|특성이 없는 파일 외에도 숨겨진 파일을 지정합니다.|
| System | vbSystem|특성이 없는 파일 외에도 시스템 파일을 지정합니다.|
| Volume | vbVolume|볼륨 레이블을 지정합니다. 다른 특성이 지정되면 vbVolume 이 무시됩니다.|
| Directory | vbDirectory|특성이 없는 파일 외에도 디렉터리 또는 폴더를 지정합니다.|
| Archive | vbArchive|마지막 백업 이후 파일이 변경되었습니다.|
| Alias | vbAlias|파일에 다른 이름이 있습니다.|

참고

이러한 열거형은 Visual Basic 언어로 지정되며 실제 값 대신 코드의 아무 곳에서나 사용할 수 있습니다.

추가 정보

• ChDir(String)
• ChDrive
• FileAttribute