Condividi tramite


FileSystem.Dir Metodo

Definizione

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 di volume di un'unità. Nelle operazioni di I/O su file, FileSystem garantisce produttività e prestazioni migliori rispetto alla funzione Dir. Per altre informazioni, vedere GetDirectoryInfo(String).

Overload

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 di volume di un'unità. Nelle operazioni di I/O su file, FileSystem garantisce produttività e prestazioni migliori rispetto alla funzione Dir. 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 di volume di un'unità. Nelle operazioni di I/O su file, FileSystem garantisce produttività e prestazioni migliori rispetto alla funzione Dir. Per altre informazioni, vedere GetDirectoryInfo(String).

Dir()

Origine:
FileSystem.vb
Origine:
FileSystem.vb
Origine:
FileSystem.vb

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 di volume di un'unità. Nelle operazioni di I/O su file, FileSystem garantisce produttività e prestazioni migliori rispetto alla funzione Dir. 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

Restituisce

Stringa che rappresenta il nome di un file, una directory o una cartella corrispondente a un determinato attributo di file o modello, oppure l'etichetta di 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 multipli (*) e caratteri jolly (?) 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.

Importante

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 FileIOPermission, SecurityExceptione Autorizzazioni di accesso al codice.

I valori di Attributes enumerazione degli argomenti sono i seguenti:

Valore Costante Descrizione
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 è stato modificato dopo l'ultimo backup.
Alias vbAlias Il file ha un nome diverso.

Nota

Queste enumerazioni vengono specificate dal linguaggio Visual Basic e possono essere usate in qualsiasi punto del codice invece dei valori effettivi.

Vedi anche

Si applica a

Dir(String, FileAttribute)

Origine:
FileSystem.vb
Origine:
FileSystem.vb
Origine:
FileSystem.vb

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 di volume di un'unità. Nelle operazioni di I/O su file, FileSystem garantisce produttività e prestazioni migliori rispetto alla funzione Dir. Per altre informazioni, vedere 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

Parametri

PathNamePathname
String

facoltativo. Espressione stringa che specifica un nome di file, directory o cartella o un'etichetta di volume di un'unità. Se PathName non viene trovato, verrà restituita una stringa di lunghezza zero ("").

Attributes
FileAttribute

facoltativo. Enumerazione o espressione numerica il cui valore specifica attributi di file. Se omesso, Dir restituisce file che corrispondono a Pathname ma sono privi di attributi.

Restituisce

Stringa che rappresenta il nome di un file, una directory o una cartella corrispondente a un determinato attributo di file o modello, oppure l'etichetta di volume di un'unità.

Attributi

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 multipli (*) e caratteri jolly (?) 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.

Importante

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 FileIOPermission, SecurityExceptione Autorizzazioni di accesso al codice.
I valori di Attributes enumerazione degli argomenti sono i seguenti:
|Valore |Costante |Descrizione|
|-|-|-|
| 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 file ha un nome diverso.|

Nota

Queste enumerazioni vengono specificate dal linguaggio Visual Basic e possono essere usate in qualsiasi punto del codice al posto dei valori effettivi.

Vedi anche

Si applica a