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

Важно!

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

Ниже Attributes приведены значения перечисления аргументов.

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

Примечание

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

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

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

Dir(String, FileAttribute)

Исходный код:
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

Необязательный элемент. Строковое выражение, задающее имя файла, имя каталога или папки, либо метку тома диска. Если параметр PathName не обнаруживается, возвращается строка нулевой длины ("").

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 функции без параметров.

Важно!

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

Примечание

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

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

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