FileSystem.Dir Метод

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.Core.dll
Сборка:
Microsoft.VisualBasic.dll

Возвращает строку, представляющую имя файла, каталога или папки, которая соответствует указанному шаблону или атрибуту файла, или метке тома диска. Это FileSystem обеспечивает лучшую производительность и производительность операций ввода-вывода файлов, чем Dir функция. См. GetDirectoryInfo(String) для получения дополнительной информации.

Перегрузки

Имя Описание
Dir()

Возвращает строку, представляющую имя файла, каталога или папки, которая соответствует указанному шаблону или атрибуту файла, или метке тома диска. Это FileSystem обеспечивает лучшую производительность и производительность операций ввода-вывода файлов, чем Dir функция. См. GetDirectoryInfo(String) для получения дополнительной информации.
Dir(String, FileAttribute)

Возвращает строку, представляющую имя файла, каталога или папки, которая соответствует указанному шаблону или атрибуту файла, или метке тома диска. Это FileSystem обеспечивает лучшую производительность и производительность операций ввода-вывода файлов, чем Dir функция. См. GetDirectoryInfo(String) для получения дополнительной информации.

Dir()

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

Возвращает строку, представляющую имя файла, каталога или папки, которая соответствует указанному шаблону или атрибуту файла, или метке тома диска. Это FileSystem обеспечивает лучшую производительность и производительность операций ввода-вывода файлов, чем Dir функция. См. 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 функции без параметров.

Important

Для правильного Dir выполнения функции требуется Read предоставить исполняемый код и PathDiscovery флаги FileIOPermission . Дополнительные сведения см. в статье FileIOPermissionи SecurityExceptionразрешениях на доступ к коду.

Значения Attributes перечисления аргументов приведены следующим образом:

Ценность Константа Description
Normal vbnormal По умолчанию. Задает файлы без атрибутов.
ReadOnly vbReadOnly Указывает файлы, доступные только для чтения, а также файлы без атрибутов.
Hidden vbHidden Задает скрытые файлы, а также файлы без атрибутов.
System vbSystem Задает системные файлы, а также файлы без атрибутов.
Volume vbVolume Указывает метку тома; Если указан любой другой атрибут, vbVolume игнорируется.
Directory vbDirectory Указывает каталоги или папки, а также файлы без атрибутов.
Archive vbArchive Файл изменился с момента создания последней резервной копии.
Alias vbAlias Файл имеет другое имя.

Note

Эти перечисления задаются языком Visual Basic и могут использоваться в любом месте кода вместо фактических значений.

См. также раздел

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

Dir(String, FileAttribute)

Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb
Исходный код:
FileSystem.vb

Возвращает строку, представляющую имя файла, каталога или папки, которая соответствует указанному шаблону или атрибуту файла, или метке тома диска. Это FileSystem обеспечивает лучшую производительность и производительность операций ввода-вывода файлов, чем Dir функция. См. GetDirectoryInfo(String) для получения дополнительной информации.

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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);
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
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. Строковое выражение, указывающее имя файла, имя каталога или папки или метку тома диска. Строка нулевой длины ("") возвращается, если PathName она не найдена.

Attributes
FileAttribute

Optional. Перечисление или числовое выражение, значение которого указывает атрибуты файла. Если опущено, 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 функции без параметров.

Important

Для правильного Dir выполнения функции требуется Read предоставить исполняемый код и PathDiscovery флаги FileIOPermission . Дополнительные сведения см. в статье FileIOPermissionи SecurityExceptionразрешениях на доступ к коду. Значения Attributes перечисления аргументов приведены следующим образом: |Значение|Констант|Описание| |-|--|-| |Normal|vbnormal|По умолчанию. Указывает файлы, у которых нет атрибутов.| |ReadOnly|vbReadOnly|Задает файлы, доступные только для чтения, в дополнение к файлам без атрибутов.| |Hidden|vbHidden|Задает скрытые файлы в дополнение к файлам без атрибутов.| |System|vbSystem|Задает системные файлы в дополнение к файлам без атрибутов.| |Volume|vbVolume|Указывает метку тома; Если указан любой другой атрибут, vbVolume игнорируется.| |Directory|vbDirectory|Задает каталоги или папки в дополнение к файлам без атрибутов.| |Archive|vbArchive|Файл изменился с момента последнего резервного копирования.| |Alias|vbAlias|Файл имеет другое имя.|

Note

Эти перечисления задаются языком Visual Basic и могут использоваться в любом месте кода вместо фактических значений.

См. также раздел

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