Aracılığıyla paylaş


FileSystem.Dir Yöntem

Tanım

Belirtilen desenle veya dosya özniteliğiyle eşleşen bir dosyanın, dizinin ya da klasörün adını ya da bir sürücünün birim etiketini 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 edinmek için bkz. GetDirectoryInfo(String).

Aşırı Yüklemeler

Dir()

Belirtilen desenle veya dosya özniteliğiyle eşleşen bir dosyanın, dizinin ya da klasörün adını ya da bir sürücünün birim etiketini 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 edinmek için bkz. GetDirectoryInfo(String).

Dir(String, FileAttribute)

Belirtilen desenle veya dosya özniteliğiyle eşleşen bir dosyanın, dizinin ya da klasörün adını ya da bir sürücünün birim etiketini 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 edinmek için bkz. GetDirectoryInfo(String).

Dir()

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

Belirtilen desenle veya dosya özniteliğiyle eşleşen bir dosyanın, dizinin ya da klasörün adını ya da bir sürücünün birim etiketini 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 edinmek 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 model veya dosya özniteliğiyle eşleşen dosya, dizin veya klasör adını ya da bir sürücünün birim etiketini temsil eden bir dize.

Örnekler

Bu örnekte, belirli dosya 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 çoklu karakter (*) ve tek karakterli (?) joker karakterlerin kullanımını destekler.

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

işlevini ilk kez çağırdığınızda Dir sağlamanız PathName gerekir. Sonraki öğeyi almak için, işleve Dir parametreler olmadan sonraki çağrıları yapabilirsiniz.

Önemli

doğru çalıştırmak Dir için, işlevi 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 Description
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ı da belirtir.
Volume vbVolume Birim etiketini belirtir; başka bir öznitelik belirtilirse yoksayılır vbVolume .
Directory vbDirectory Dizinleri veya klasörleri ve öznitelikleri olmayan dosyaları belirtir.
Archive vbArchive Dosya, son yedeklemeden bu yana değişti.
Alias vbAlias Dosya farklı bir ada sahip.

Not

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

Belirtilen desenle veya dosya özniteliğiyle eşleşen bir dosyanın, dizinin ya da klasörün adını ya da bir sürücünün birim etiketini 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 edinmek 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

İsteğe bağlı. Dosya adını, dizin veya klasör adını ya da sürücü birimi etiketini belirten dize ifadesi. Bulunamazsa PathName sıfır uzunluklu bir dize ("") döndürülür.

Attributes
FileAttribute

İsteğe bağlı. 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 model veya dosya özniteliğiyle eşleşen dosya, dizin veya klasör adını ya da bir sürücünün birim etiketini temsil eden bir dize.

Öznitelikler

Örnekler

Bu örnekte, belirli dosya 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 çoklu karakter (*) ve tek karakterli (?) joker karakterlerin kullanımını destekler.
VbVolume belirli bir dosya adı yerine sürücü için birim etiketini döndürür.
işlevini ilk kez çağırdığınızda Dir sağlamanız PathName gerekir. Sonraki öğeyi almak için, işleve Dir parametre olmadan sonraki çağrıları yapabilirsiniz.

Önemli

doğru çalıştırmak Dir için, işlevi 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. Özniteliği olmayan dosyaları belirtir.|
| ReadOnly | vbReadOnly|Özniteliği 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ır vbVolume .|
| 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ı.|

Not

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