Share via


FileSystem.Dir Metode

Definisi

Mengembalikan string yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive. memberi FileSystem Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Dir fungsi . Lihat GetDirectoryInfo(String) untuk informasi lebih lanjut.

Overload

Dir()

Mengembalikan string yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive. memberi FileSystem Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Dir fungsi . Lihat GetDirectoryInfo(String) untuk informasi lebih lanjut.

Dir(String, FileAttribute)

Mengembalikan string yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive. memberi FileSystem Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Dir fungsi . Lihat GetDirectoryInfo(String) untuk informasi lebih lanjut.

Dir()

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Mengembalikan string yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive. memberi FileSystem Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Dir fungsi . Lihat GetDirectoryInfo(String) untuk informasi lebih lanjut.

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

Mengembalikan

String yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive.

Contoh

Contoh ini menggunakan Dir fungsi untuk memeriksa apakah ada file dan direktori tertentu.

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

Keterangan

Fungsi ini Dir mendukung penggunaan kartubebas beberapa karakter (*) dan karakter tunggal (?) untuk menentukan beberapa file.

VbVolume mengembalikan label volume untuk drive alih-alih nama file tertentu.

Anda harus menyediakan PathName pertama kalinya Anda memanggil Dir fungsi. Untuk mengambil item berikutnya, Anda dapat melakukan panggilan berikutnya ke Dir fungsi tanpa parameter.

Penting

Untuk berjalan dengan benar, Dir fungsi mengharuskan Read bendera FileIOPermission dan PathDiscovery diberikan ke kode yang dieksekusi. Untuk informasi selengkapnya, lihat FileIOPermission, , SecurityExceptiondan Izin Akses Kode.

Nilai Attributes enumerasi argumen adalah sebagai berikut:

Nilai Terus-menerus Deskripsi
Normal vbnormal Default. Menentukan file tanpa atribut.
ReadOnly vbReadOnly Menentukan file baca-saja, dan juga file tanpa atribut.
Hidden vbHidden Menentukan file tersembunyi, dan juga file tanpa atribut.
System vbSystem Menentukan file sistem, dan juga file tanpa atribut.
Volume vbVolume Menentukan label volume; jika ada atribut lain yang ditentukan, vbVolume diabaikan.
Directory vbDirectory Menentukan direktori atau folder, dan juga file tanpa atribut.
Archive vbArchive File telah berubah sejak pencadangan terakhir.
Alias vbAlias File memiliki nama yang berbeda.

Catatan

Enumerasi ini ditentukan oleh bahasa Visual Basic dan dapat digunakan di mana saja dalam kode Anda alih-alih nilai aktual.

Lihat juga

Berlaku untuk

Dir(String, FileAttribute)

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Mengembalikan string yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive. memberi FileSystem Anda produktivitas dan performa yang lebih baik dalam operasi I/O file daripada Dir fungsi . Lihat GetDirectoryInfo(String) untuk informasi lebih lanjut.

[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

Parameter

PathNamePathname
String

Pilihan. Ekspresi string yang menentukan nama file, nama direktori atau folder, atau label volume drive. String panjang nol ("") dikembalikan jika PathName tidak ditemukan.

Attributes
FileAttribute

Pilihan. Enumerasi atau ekspresi numerik yang nilainya menentukan atribut file. Jika dihilangkan, Dir mengembalikan file yang cocok Pathname tetapi tidak memiliki atribut.

Mengembalikan

String yang mewakili nama file, direktori, atau folder yang cocok dengan pola atau atribut file tertentu, atau label volume drive.

Atribut

Contoh

Contoh ini menggunakan Dir fungsi untuk memeriksa apakah ada file dan direktori tertentu.

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

Keterangan

Fungsi ini Dir mendukung penggunaan kartubebas beberapa karakter (*) dan karakter tunggal (?) untuk menentukan beberapa file.
VbVolume mengembalikan label volume untuk drive alih-alih nama file tertentu.
Anda harus menyediakan PathName pertama kalinya Anda memanggil Dir fungsi. Untuk mengambil item berikutnya, Anda dapat melakukan panggilan berikutnya ke Dir fungsi tanpa parameter.

Penting

Untuk berjalan dengan benar, Dir fungsi mengharuskan Read bendera FileIOPermission dan PathDiscovery diberikan ke kode yang dieksekusi. Untuk informasi selengkapnya, lihat FileIOPermission, , SecurityExceptiondan Izin Akses Kode.
Nilai Attributes enumerasi argumen adalah sebagai berikut:
|Nilai|Konstanta|Deskripsi|
|-|-|-|
|Normal|vbnormal|Default. Menentukan file yang tidak memiliki atribut.|
|ReadOnly|vbReadOnly|Menentukan file baca-saja, selain file yang tidak memiliki atribut.|
|Hidden|vbHidden|Menentukan file tersembunyi, selain file yang tidak memiliki atribut.|
|System|vbSystem|Menentukan file sistem, selain file yang tidak memiliki atribut.|
|Volume|vbVolume|Menentukan label volume; jika ada atribut lain yang ditentukan, vbVolume diabaikan.|
|Directory|vbDirectory|Menentukan direktori atau folder, selain file yang tidak memiliki atribut.|
|Archive|vbArchive|File telah berubah sejak pencadangan terakhir.|
|Alias|vbAlias|File memiliki nama yang berbeda.|

Catatan

Enumerasi ini ditentukan oleh bahasa Visual Basic dan dapat digunakan di mana saja dalam kode Anda sebagai pengganti nilai aktual.

Lihat juga

Berlaku untuk