FileSystem.Dir Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

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

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

String

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.

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string

Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Parametreler

PathName

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

String

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

SupportedOSPlatformAttribute

Ö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.

• ChDir(String)
• ChDrive
• FileAttribute