FileSystem.Dir Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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(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()
- 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.