FileSystem.Dir メソッド

定義

指定パターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列を返します。Returns a string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive. FileSystem を使用すると、Dir 関数を使用した場合より I/O 操作の生産性およびパフォーマンスが向上します。The FileSystem gives you better productivity and performance in file I/O operations than the Dir function. 詳細については、「GetDirectoryInfo(String)」を参照してください。See GetDirectoryInfo(String) for more information.

オーバーロード

Dir()

指定パターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列を返します。Returns a string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive. FileSystem を使用すると、Dir 関数を使用した場合より I/O 操作の生産性およびパフォーマンスが向上します。The FileSystem gives you better productivity and performance in file I/O operations than the Dir function. 詳細については、「GetDirectoryInfo(String)」を参照してください。See GetDirectoryInfo(String) for more information.

Dir(String, FileAttribute)

指定パターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列を返します。Returns a string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive. FileSystem を使用すると、Dir 関数を使用した場合より I/O 操作の生産性およびパフォーマンスが向上します。The FileSystem gives you better productivity and performance in file I/O operations than the Dir function. 詳細については、「GetDirectoryInfo(String)」を参照してください。See GetDirectoryInfo(String) for more information.

Dir()

指定パターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列を返します。Returns a string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive. FileSystem を使用すると、Dir 関数を使用した場合より I/O 操作の生産性およびパフォーマンスが向上します。The FileSystem gives you better productivity and performance in file I/O operations than the Dir function. 詳細については、「GetDirectoryInfo(String)」を参照してください。See GetDirectoryInfo(String) for more information.

public:
 static System::String ^ Dir();
public static string Dir ();
static member Dir : unit -> string
Public Function Dir () As String

戻り値

指定されたパターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列。A string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive.

この例では、Dir 関数を使用して、特定のファイルとディレクトリが存在するかどうかを確認します。This example uses the Dir function to check if certain files and directories exist.

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 関数では、複数のファイルを指定するために複数の文字 (*) と1文字の (?) ワイルドカードを使用できます。The Dir function supports the use of multiple-character (*) and single-character (?) wildcards to specify multiple files.

VbVolume は、特定のファイル名ではなく、ドライブのボリュームラベルを返します。VbVolume returns the volume label for the drive instead of a specific file name.

Dir 関数を初めて呼び出すときは、PathName を指定する必要があります。You must supply a PathName the first time that you call the Dir function. 次の項目を取得するには、パラメーターを指定せずに Dir 関数への後続の呼び出しを行うことができます。To retrieve the next item, you can make subsequent calls to the Dir function without parameters.

重要

正常に実行するには、Dir 関数で、実行中のコードに対して FileIOPermissionReadPathDiscovery フラグを与える必要があります。To run correctly, the Dir function requires the Read and PathDiscovery flags of FileIOPermission to be granted to the executing code. 詳細については、「FileIOPermissionSecurityException、およびコードアクセス許可」を参照してください。For more information, see FileIOPermission, SecurityException, and Code Access Permissions.

Attributes 引数の列挙値は次のとおりです。The Attributes argument enumeration values are as follows:

[値]Value 定数Constant 説明Description
Normal vbnormal 既定モード。Default. 属性のないファイルを指定します。Specifies files without attributes.
ReadOnly vbReadOnly 読み取り専用ファイルと、属性のないファイルを指定します。Specifies read-only files, and also files without attributes.
Hidden vbHidden 隠しファイル、および属性のないファイルを指定します。Specifies hidden files, and also files without attributes.
System vbSystem システムファイル、および属性のないファイルを指定します。Specifies system files, and also files without attributes.
Volume vbVolume ボリュームラベルを指定します。他の属性が指定されている場合、vbVolume は無視されます。Specifies volume label; if any other attribute is specified, vbVolume is ignored.
Directory vbDirectory ディレクトリまたはフォルダー、および属性のないファイルを指定します。Specifies directories or folders, and also files without attributes.
Archive vbArchive ファイルは前回のバックアップ以降に変更されています。File has changed since last backup.
Alias vbAlias ファイルに別の名前が付いています。File has a different name.

注意

これらの列挙は Visual Basic 言語によって指定され、実際の値の代わりにコード内の任意の場所で使用できます。These enumerations are specified by the Visual Basic language and can be used anywhere in your code instead of the actual values.

こちらもご覧ください

Dir(String, FileAttribute)

指定パターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列を返します。Returns a string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive. FileSystem を使用すると、Dir 関数を使用した場合より I/O 操作の生産性およびパフォーマンスが向上します。The FileSystem gives you better productivity and performance in file I/O operations than the Dir function. 詳細については、「GetDirectoryInfo(String)」を参照してください。See GetDirectoryInfo(String) for more information.

public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir (string Pathname, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String
Public Function Dir (Pathname As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

パラメーター

PathNamePathname
String

任意。Optional. ファイル名、ディレクトリまたはフォルダー名、あるいはドライブ ボリューム ラベルを指定する文字列式です。A string expression that specifies a file name, directory or folder name, or drive volume label. PathName が見つからない場合は、長さ 0 の文字列 ("") が返されます。A zero-length string ("") is returned if PathName is not found.

Attributes
FileAttribute

任意。Optional. 値がファイル属性を指定する列挙式または数式。Enumeration or numeric expression whose value specifies file attributes. 省略した場合、Dir は、Pathname に一致する、属性のないファイルを返します。If omitted, Dir returns files that match Pathname but have no attributes.

戻り値

指定されたパターンまたはファイル属性と一致するファイル名、ディレクトリ名、フォルダー名を表す文字列、またはドライブのボリューム ラベルを表す文字列。A string representing the name of a file, directory, or folder that matches a specified pattern or file attribute, or the volume label of a drive.

この例では、Dir 関数を使用して、特定のファイルとディレクトリが存在するかどうかを確認します。This example uses the Dir function to check if certain files and directories exist.

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 関数では、複数のファイルを指定するために複数の文字 (*) と1文字の (?) ワイルドカードを使用できます。The Dir function supports the use of multiple-character (*) and single-character (?) wildcards to specify multiple files.
VbVolume は、特定のファイル名ではなく、ドライブのボリュームラベルを返します。VbVolume returns the volume label for the drive instead of a specific file name.
Dir 関数を初めて呼び出すときは、PathName を指定する必要があります。You must supply a PathName the first time that you call the Dir function. 次の項目を取得するには、パラメーターを使用せずに Dir 関数への後続の呼び出しを行うことができます。To retrieve the next item, you can make subsequent calls to the Dir function with no parameters.

重要

正常に実行するには、Dir 関数で、実行中のコードに対して FileIOPermissionReadPathDiscovery フラグを与える必要があります。To run correctly, the Dir function requires the Read and PathDiscovery flags of FileIOPermission to be granted to the executing code. 詳細については、「FileIOPermissionSecurityException、およびコードアクセス許可」を参照してください。For more information, see FileIOPermission, SecurityException, and Code Access Permissions.
Attributes 引数の列挙値は次のとおりです。The Attributes argument enumeration values are as follows:
|[値]Value|定数Constant|説明Description|
|-|-|-|
|Normal|vbnormal|既定モード。Default. 属性を持たないファイルを指定します。Specifies files that have no attributes.|
|ReadOnly|vbReadOnly|属性を持たないファイルに加えて、読み取り専用ファイルを指定します。Specifies read-only files, in addition to files that have no attributes.|
|Hidden|vbHidden|属性を持たないファイルに加えて、隠しファイルを指定します。Specifies hidden files, in addition to files that have no attributes.|
|System|vbSystem|属性を持たないファイルに加えて、システムファイルを指定します。Specifies system files, in addition to files that have no attributes.|
|Volume|vbVolume|ボリュームラベルを指定します。他の属性が指定されている場合、vbVolume は無視されます。Specifies volume label; if any other attribute is specified, vbVolume is ignored.|
|Directory|vbDirectory|属性を持たないファイルに加えて、ディレクトリまたはフォルダーを指定します。Specifies directories or folders, in addition to files that have no attributes.|
|Archive|vbArchive|ファイルは前回のバックアップ以降に変更されています。File has changed since last backup.|
|Alias|vbAlias|ファイルに別の名前が付いています。File has a different name.|

注意

これらの列挙は Visual Basic 言語によって指定され、実際の値の代わりにコード内の任意の場所で使用できます。These enumerations are specified by the Visual Basic language and can be used anywhere in your code in place of the actual values.

こちらもご覧ください

適用対象