FileSystem.Dir Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.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, č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

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

String

Ř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é

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

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

[<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

Parametry

PathName

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

String

Ř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

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í 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é

• ChDir(String)
• ChDrive
• FileAttribute