FileSystem.Dir Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Restituisce una stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o a un attributo di file specificato oppure all'etichetta del volume di un'unità. offre FileSystem una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto alla Dir funzione . Per altre informazioni, vedere GetDirectoryInfo(String).

Overload

Nome Descrizione
Dir()

Restituisce una stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o a un attributo di file specificato oppure all'etichetta del volume di un'unità. offre FileSystem una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto alla Dir funzione . Per altre informazioni, vedere GetDirectoryInfo(String).
Dir(String, FileAttribute)

Restituisce una stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o a un attributo di file specificato oppure all'etichetta del volume di un'unità. offre FileSystem una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto alla Dir funzione . Per altre informazioni, vedere GetDirectoryInfo(String).

Dir()

Restituisce una stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o a un attributo di file specificato oppure all'etichetta del volume di un'unità. offre FileSystem una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto alla Dir funzione . Per altre informazioni, vedere GetDirectoryInfo(String).

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

Valori restituiti

String

Stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o un attributo di file specificato o l'etichetta del volume di un'unità.

Esempio

In questo esempio viene usata la Dir funzione per verificare se esistono determinati file e directory.

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

Commenti

La Dir funzione supporta l'uso di caratteri jolly multipli (*) e carattere singolo (?) per specificare più file.

VbVolume restituisce l'etichetta del volume per l'unità anziché un nome di file specifico.

È necessario specificare una PathName prima volta che si chiama la Dir funzione . Per recuperare l'elemento successivo, è possibile effettuare chiamate successive alla Dir funzione senza parametri.

Important

Per l'esecuzione corretta, la Dir funzione richiede che i Read flag e PathDiscovery di FileIOPermission vengano concessi al codice in esecuzione. Per altre informazioni, vedere FileIOPermissionAutorizzazioni di accesso al codice , SecurityExceptione .

I valori di Attributes enumerazione degli argomenti sono i seguenti:

Value Costante Description
Normal vbnormal Valore predefinito. Specifica i file senza attributi.
ReadOnly vbReadOnly Specifica i file di sola lettura e anche i file senza attributi.
Hidden vbHidden Specifica i file nascosti e anche i file senza attributi.
System vbSystem Specifica i file di sistema e anche i file senza attributi.
Volume vbVolume Specifica l'etichetta del volume; se viene specificato un altro attributo, vbVolume viene ignorato.
Directory vbDirectory Specifica directory o cartelle e anche file senza attributi.
Archive vbArchive Il file è cambiato dall'ultimo backup.
Alias vbAlias Il nome del file è diverso.

Note

Queste enumerazioni vengono specificate dal linguaggio Visual Basic e possono essere usate ovunque nel codice anziché i valori effettivi.

Vedi anche

Si applica a

Dir(String, FileAttribute)

Restituisce una stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o a un attributo di file specificato oppure all'etichetta del volume di un'unità. offre FileSystem una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto alla Dir funzione . Per altre informazioni, vedere GetDirectoryInfo(String).

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

Parametri

PathnamePathName
String

Optional. Espressione stringa che specifica un nome di file, una directory o un nome di cartella o un'etichetta del volume dell'unità. Se non viene trovata, viene restituita Pathname una stringa di lunghezza zero ("").

Attributes
FileAttribute

Optional. Enumerazione o espressione numerica il cui valore specifica gli attributi del file. Se omesso, Dir restituisce i file che corrispondono Pathname ma non hanno attributi.

Valori restituiti

String

Stringa che rappresenta il nome di un file, di una directory o di una cartella corrispondente a un criterio o un attributo di file specificato o l'etichetta del volume di un'unità.

Esempio

In questo esempio viene usata la Dir funzione per verificare se esistono determinati file e directory.

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

Commenti

La Dir funzione supporta l'uso di caratteri jolly multipli (*) e carattere singolo (?) per specificare più file. VbVolume restituisce l'etichetta del volume per l'unità anziché un nome di file specifico. È necessario specificare una PathName prima volta che si chiama la Dir funzione . Per recuperare l'elemento successivo, è possibile effettuare chiamate successive alla Dir funzione senza parametri.

Important

Per l'esecuzione corretta, la Dir funzione richiede che i Read flag e PathDiscovery di FileIOPermission vengano concessi al codice in esecuzione. Per altre informazioni, vedere FileIOPermissionAutorizzazioni di accesso al codice , SecurityExceptione . I valori di Attributes enumerazione degli argomenti sono i seguenti: |Valore |Costante |Description| |-|-|-| || |Normal|vbnormal|Predefinito. Specifica i file senza attributi.| |ReadOnly|vbReadOnly|Specifica i file di sola lettura, oltre ai file senza attributi.| |Hidden|vbHidden|Specifica i file nascosti, oltre ai file senza attributi. |System|vbSystem|Specifica i file di sistema, oltre ai file senza attributi. |Volume|vbVolume|Specifica l'etichetta del volume; se viene specificato un altro attributo, vbVolume viene ignorato.| |Directory|vbDirectory|Specifica directory o cartelle, oltre ai file senza attributi.| |Archive|vbArchive|Il file è stato modificato dopo l'ultimo backup.| |Alias|vbAlias|Il nome del file è diverso.|

Note

Queste enumerazioni vengono specificate dal linguaggio Visual Basic e possono essere usate ovunque nel codice al posto dei valori effettivi.

Vedi anche

Si applica a