FileSystem.Dir Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.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 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()

Source:

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

String

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

• ChDir(String)
• ChDrive
• FileAttribute

Dir(String, FileAttribute)

Source:

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

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

Parametri

PathName

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

String

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

SupportedOSPlatformAttribute

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

• ChDir(String)
• ChDrive
• FileAttribute