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.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.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.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.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 поддерживает использование подстановочных знаков с несколькими символами (*) и одним символом (?) для указания нескольких файлов.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.

Необходимо указать PathName при первом вызове функции Dir.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 требуется, чтобы Read и PathDiscovery флаги FileIOPermission были предоставлены выполняемому коду.To run correctly, the Dir function requires the Read and PathDiscovery flags of FileIOPermission to be granted to the executing code. Дополнительные сведения см. в разделе FileIOPermission, SecurityExceptionи разрешения на доступ к коду.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.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);
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

Необязательный параметр.Optional. Строковое выражение, задающее имя файла, имя каталога или папки, либо метку тома диска.A string expression that specifies a file name, directory or folder name, or drive volume label. Если параметр PathName не обнаруживается, возвращается строка нулевой длины ("").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 поддерживает использование подстановочных знаков с несколькими символами (*) и одним символом (?) для указания нескольких файлов.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.
Необходимо указать PathName при первом вызове функции Dir.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 требуется, чтобы Read и PathDiscovery флаги FileIOPermission были предоставлены выполняемому коду.To run correctly, the Dir function requires the Read and PathDiscovery flags of FileIOPermission to be granted to the executing code. Дополнительные сведения см. в разделе FileIOPermission, SecurityExceptionи разрешения на доступ к коду.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.

Дополнительно

Применяется к