FileSystem.Dir Yöntem

Tanım

Belirtilen desen veya dosya özniteliğiyle veya bir sürücünün birim etiketiyle eşleşen bir dosya, dizin veya klasörün adını temsil eden bir dize döndürür. , FileSystem dosya G/Ç işlemlerinde işlevden Dir daha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. GetDirectoryInfo(String).

Aşırı Yüklemeler

Name Description
Dir()

Belirtilen desen veya dosya özniteliğiyle veya bir sürücünün birim etiketiyle eşleşen bir dosya, dizin veya klasörün adını temsil eden bir dize döndürür. , FileSystem dosya G/Ç işlemlerinde işlevden Dir daha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. GetDirectoryInfo(String).

Dir(String, FileAttribute)

Belirtilen desen veya dosya özniteliğiyle veya bir sürücünün birim etiketiyle eşleşen bir dosya, dizin veya klasörün adını temsil eden bir dize döndürür. , FileSystem dosya G/Ç işlemlerinde işlevden Dir daha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. GetDirectoryInfo(String).

Dir()

Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Belirtilen desen veya dosya özniteliğiyle veya bir sürücünün birim etiketiyle eşleşen bir dosya, dizin veya klasörün adını temsil eden bir dize döndürür. , FileSystem dosya G/Ç işlemlerinde işlevden Dir daha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. GetDirectoryInfo(String).

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

Döndürülenler

Belirtilen desen veya dosya özniteliğiyle eşleşen bir dosya, dizin veya klasörün adını ya da bir sürücünün birim etiketini temsil eden bir dize.

Örnekler

Bu örnekte, belirli dosyaların ve dizinlerin mevcut olup olmadığını denetlemek için işlevi kullanılır 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

Açıklamalar

İşlev, Dir birden çok dosya belirtmek için birden çok karakter (*) ve tek karakterli (?) joker karakter kullanımını destekler.

VbVolume belirli bir dosya adı yerine sürücü için birim etiketini döndürür.

İşlevi ilk kez çağırdığınızda PathName sağlamanız gerekirDir. Sonraki öğeyi almak için parametresiz işleve Dir sonraki çağrılar yapabilirsiniz.

Important

düzgün çalışmak için işlevi, Dir yürütme koduna Read ve PathDiscovery bayraklarının FileIOPermission verilmesini gerektirir. Daha fazla bilgi için bkz FileIOPermission. , SecurityExceptionve Kod Erişim İzinleri.

Attributes Bağımsız değişken numaralandırma değerleri aşağıdaki gibidir:

Değer Sabit Açıklama
Normal vbnormal Varsayılan. Öznitelikleri olmayan dosyaları belirtir.
ReadOnly vbReadOnly Salt okunur dosyaları ve öznitelikleri olmayan dosyaları belirtir.
Hidden vbHidden Gizli dosyaları ve öznitelikleri olmayan dosyaları belirtir.
System vbSystem Sistem dosyalarını ve öznitelikleri olmayan dosyaları belirtir.
Volume vbVolume Birim etiketini belirtir; başka bir öznitelik belirtilirse yoksayılır vbVolume .
Directory vbDirectory Dizinleri veya klasörleri ve ayrıca öznitelikleri olmayan dosyaları belirtir.
Archive vbArchive Son yedeklemeden bu yana dosya değişti.
Alias vbAlias Dosyanın adı farklı.

Note

Bu numaralandırmalar Visual Basic dili tarafından belirtilir ve kodunuzda gerçek değerler yerine herhangi bir yerde kullanılabilir.

Ayrıca bkz.

Şunlara uygulanır

Dir(String, FileAttribute)

Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb
Kaynak:
FileSystem.vb

Belirtilen desen veya dosya özniteliğiyle veya bir sürücünün birim etiketiyle eşleşen bir dosya, dizin veya klasörün adını temsil eden bir dize döndürür. , FileSystem dosya G/Ç işlemlerinde işlevden Dir daha iyi üretkenlik ve performans sağlar. Daha fazla bilgi için bkz. 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

Parametreler

PathNamePathname
String

Optional. Bir dosya adı, dizin veya klasör adı ya da sürücü birimi etiketi belirten bir dize ifadesi. Sıfır uzunluklu dize ("") bulunamazsa PathName döndürülür.

Attributes
FileAttribute

Optional. Değeri dosya özniteliklerini belirten numaralandırma veya sayısal ifade. Atlanırsa, Dir eşleşen Pathname ancak özniteliği olmayan dosyaları döndürür.

Döndürülenler

Belirtilen desen veya dosya özniteliğiyle eşleşen bir dosya, dizin veya klasörün adını ya da bir sürücünün birim etiketini temsil eden bir dize.

Öznitelikler

Örnekler

Bu örnekte, belirli dosyaların ve dizinlerin mevcut olup olmadığını denetlemek için işlevi kullanılır 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

Açıklamalar

İşlev, Dir birden çok dosya belirtmek için birden çok karakter (*) ve tek karakterli (?) joker karakter kullanımını destekler. VbVolume belirli bir dosya adı yerine sürücü için birim etiketini döndürür. İşlevi ilk kez çağırdığınızda PathName sağlamanız gerekirDir. Sonraki öğeyi almak için parametresiz olarak işleve Dir sonraki çağrılar yapabilirsiniz.

Important

düzgün çalışmak için işlevi, Dir yürütme koduna Read ve PathDiscovery bayraklarının FileIOPermission verilmesini gerektirir. Daha fazla bilgi için bkz FileIOPermission. , SecurityExceptionve Kod Erişim İzinleri. Bağımsız Attributes değişken numaralandırma değerleri aşağıdaki gibidir: |Değer|Sabit|Açıklama| |-|-|-| |Normal|vbnormal|Varsayılan. Özniteliği olmayan dosyaları belirtir.| |ReadOnly|vbReadOnly|Öznitelikleri olmayan dosyalara ek olarak salt okunur dosyaları belirtir.| |Hidden|vbHidden|Öznitelikleri olmayan dosyalara ek olarak gizli dosyaları da belirtir.| |System|vbSystem|Öznitelikleri olmayan dosyalara ek olarak sistem dosyalarını belirtir.| |Volume|vbVolume|Birim etiketini belirtir; başka bir öznitelik belirtilirse yoksayılırvbVolume.| |Directory|vbDirectory|Öznitelikleri olmayan dosyalara ek olarak dizinleri veya klasörleri belirtir.| |Archive|vbArchive|Dosya son yedeklemeden sonra değişti.| |Alias|vbAlias|Dosyanın adı farklı.|

Note

Bu numaralandırmalar Visual Basic dili tarafından belirtilir ve kodunuzda gerçek değerler yerine herhangi bir yerde kullanılabilir.

Ayrıca bkz.

Şunlara uygulanır