FileSystem.Dir Metoda

Definice

Obor názvů:
Microsoft.VisualBasic
Sestavení:
Microsoft.VisualBasic.Core.dll
Sestavení:
Microsoft.VisualBasic.dll

Vrátí řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisku svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon v vstupně-výstupních operacích souborů než funkce Dir . Další informace naleznete na GetDirectoryInfo(String).

Přetížení

Name Description
Dir()

Vrátí řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisku svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon v vstupně-výstupních operacích souborů než funkce Dir . Další informace naleznete na GetDirectoryInfo(String).
Dir(String, FileAttribute)

Vrátí řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisku svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon v vstupně-výstupních operacích souborů než funkce Dir . Další informace naleznete na GetDirectoryInfo(String).

Dir()

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Vrátí řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisku svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon v vstupně-výstupních operacích souborů než funkce Dir . Další informace naleznete na GetDirectoryInfo(String).

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

Návraty

String

Řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisek svazku jednotky.

Příklady

Tento příklad používá Dir funkci ke kontrole, jestli existují určité soubory a adresáře.

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

Poznámky

Funkce Dir podporuje použití zástupných znaků s více znaky (*) a zástupných znaků s jedním znakem (?) k určení více souborů.

VbVolume vrátí popisek svazku pro jednotku místo konkrétního názvu souboru.

Při prvním volání PathName funkce je nutné zadatDir. Pokud chcete načíst další položku, můžete provést následná volání Dir funkce bez parametrů.

Important

Aby funkce fungovala správně, Dir vyžadujeRead, aby se prováděcímu kódu udělily PathDiscovery příznaky a FileIOPermission příznaky. Další informace naleznete v tématu FileIOPermission, SecurityExceptiona oprávnění pro přístup ke kódu.

Hodnoty Attributes výčtu argumentů jsou následující:

Hodnota Konstanta Description
Normal vbnormal Výchozí. Určuje soubory bez atributů.
ReadOnly vbReadOnly Určuje soubory jen pro čtení a také soubory bez atributů.
Hidden vbHidden Určuje skryté soubory a také soubory bez atributů.
System vbSystem Určuje systémové soubory a také soubory bez atributů.
Volume vbVolume Určuje popisek svazku; pokud je zadán jakýkoli jiný atribut, vbVolume bude ignorován.
Directory vbDirectory Určuje adresáře nebo složky a také soubory bez atributů.
Archive vbArchive Soubor se od posledního zálohování změnil.
Alias vbAlias Soubor má jiný název.

Note

Tyto výčty jsou určeny jazykem Visual Basic a dají se použít kdekoli v kódu místo skutečných hodnot.

Viz také

Platí pro

Dir(String, FileAttribute)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Vrátí řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisku svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon v vstupně-výstupních operacích souborů než funkce Dir . Další informace naleznete na 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

Parametry

PathNamePathname
String

Optional. Řetězcový výraz, který určuje název souboru, název adresáře nebo složky nebo popisek svazku jednotky. Řetězec nulové délky ("") se vrátí, pokud PathName nebyl nalezen.

Attributes
FileAttribute

Optional. Výčet nebo číselný výraz, jehož hodnota určuje atributy souboru. Pokud tento parametr vynecháte, vrátí soubory, které odpovídajíDir, Pathname ale nemají žádné atributy.

Návraty

String

Řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, nebo popisek svazku jednotky.

Atributy
SupportedOSPlatformAttribute

Příklady

Tento příklad používá Dir funkci ke kontrole, jestli existují určité soubory a adresáře.

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

Poznámky

Funkce Dir podporuje použití zástupných znaků s více znaky (*) a zástupných znaků s jedním znakem (?) k určení více souborů. VbVolume vrátí popisek svazku pro jednotku místo konkrétního názvu souboru. Při prvním volání PathName funkce je nutné zadatDir. Pokud chcete načíst další položku, můžete provést následná volání Dir funkce bez parametrů.

Important

Aby funkce fungovala správně, Dir vyžadujeRead, aby se prováděcímu kódu udělily PathDiscovery příznaky a FileIOPermission příznaky. Další informace naleznete v tématu FileIOPermission, SecurityExceptiona oprávnění pro přístup ke kódu. Hodnoty Attributes výčtu argumentů jsou následující: |Hodnota|Konstanta |Popis| |-|-|-|| || |Normal|vbnormal|Výchozí. Určuje soubory, které nemají žádné atributy.| |ReadOnly|vbReadOnly|Určuje soubory jen pro čtení, kromě souborů, které nemají žádné atributy.| |Hidden|vbHidden|Určuje skryté soubory kromě souborů, které nemají žádné atributy.| |System|vbSystem|Určuje systémové soubory kromě souborů, které nemají žádné atributy.| |Volume|vbVolume|Určuje popisek svazku; pokud je zadán jakýkoli jiný atribut, vbVolume je ignorován.| |Directory|vbDirectory|Určuje adresáře nebo složky kromě souborů, které nemají žádné atributy.| |Archive|vbArchive|Soubor se od posledního zálohování změnil.| |Alias|vbAlias|Soubor má jiný název.|

Note

Tyto výčty jsou určeny jazykem Visual Basic a mohou být použity kdekoli ve vašem kódu místo skutečných hodnot.

Viz také

Platí pro