Sdílet prostřednictvím


FileSystem.Dir Metoda

Definice

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

Přetížení

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, či popisek svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon při vstupně-výstupních operacích souborů než Dir funkce. Další informace naleznete v tématu 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, či popisek svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon při vstupně-výstupních operacích souborů než Dir funkce. Další informace naleznete v tématu GetDirectoryInfo(String).

Dir()

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, či popisek svazku jednotky. Poskytuje FileSystem lepší produktivitu a výkon při vstupně-výstupních operacích souborů než Dir funkce. Další informace naleznete v tématu GetDirectoryInfo(String).

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

Návraty

Řetězec představující název souboru, adresáře nebo složky, který odpovídá zadanému vzoru nebo atributu souboru, či 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í více znaků (*) a jednoznamových () zástupných znaků (?) k určení více souborů.

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

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

Důležité

Aby funkce Dir běžela správně, vyžadujeRead, aby spouštěný kód měl udělené příznaky FileIOPermission a PathDiscovery . Další informace najdete v tématech FileIOPermission, SecurityExceptiona Přístupová oprávnění ke kódu.

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

Hodnota Konstanta Description
Normal vbnormal Default (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 je 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.

Poznámka

Tyto výčty jsou určeny jazykem Visual Basic a lze je 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

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

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

Attributes
FileAttribute

Nepovinný parametr. Výčet nebo číselný výraz, jehož hodnota určuje atributy souboru. Pokud je vynechán, vrátí soubory, Dir které se shodují Pathname , ale nemají žádné atributy.

Návraty

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

Atributy

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í více znaků (*) a jednoznamových () zástupných znaků (?) k určení více souborů.
VbVolume vrátí popisek svazku pro jednotku místo konkrétního názvu souboru.
Je nutné zadat PathName při prvním volání Dir funkce. Pokud chcete načíst další položku, můžete provést následná volání Dir funkce bez parametrů.

Důležité

Aby funkce Dir běžela správně, vyžadujeRead, aby spouštěný kód měl udělené příznaky FileIOPermission a PathDiscovery . Další informace najdete v tématech FileIOPermission, SecurityExceptiona Přístupová oprávnění 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|Kromě souborů, které nemají žádné atributy, určuje soubory jen pro čtení.|
| Hidden | vbHidden|Kromě souborů, které nemají žádné atributy, určuje skryté soubory.|
| 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 bude ignorován.|
| Directory | vbDirectory|Určuje kromě souborů, které nemají žádné atributy, adresáře nebo složky.|
| Archive | vbArchive|Soubor se od posledního zálohování změnil.|
| Alias | vbAlias|Soubor má jiný název.|

Poznámka

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

Viz také

Platí pro