FileSystem.GetAttr, méthode

Article
08/21/2007

Retourne une valeur FileAttribute qui représente les attributs d'un fichier, répertoire ou dossier. La fonctionnalité My permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que FileAttribute. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function GetAttr ( _
    PathName As String _
) As FileAttribute
'Utilisation
Dim PathName As String
Dim returnValue As FileAttribute

returnValue = FileSystem.GetAttr(PathName)

public static FileAttribute GetAttr (
    string PathName
)

public:
static FileAttribute GetAttr (
    String^ PathName
)

public static FileAttribute GetAttr (
    String PathName
)

public static function GetAttr (
    PathName : String
) : FileAttribute

Paramètres

PathName
Obligatoire. Expression String qui spécifie un nom de fichier, de répertoire ou de dossier. PathName peut inclure le répertoire ou le dossier, ainsi que le lecteur.

Valeur de retour

Valeur Normal, Constante vbNormal, Description normale. Valeur ReadOnly, ConstantevbReadOnly,Description lecture seule. Valeur Hidden, Constante vbHidden, Description masquée. Valeur System, Constante vbSystem,Description fichier système. Valeur Directory,Constante vbDirectoryDescription répertoire ou dossier. Valeur Archive,Constante vbArchive,Description fichier modifié depuis la dernière sauvegarde. Valeur Alias,Constante vbAlias,Description fichier porte un nom différent.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic GetAttr, fonction.

Pour déterminer quels attributs sont définis, utilisez l'opérateur And pour exécuter une comparaison des bits de la valeur retournée par la fonction GetAttr et de la valeur de l'attribut de fichier individuel souhaité. Si le résultat n'est pas nul, cet attribut est défini pour le fichier nommé. Par exemple, la valeur de retour de l'expression And suivante est nulle si l'attribut Archive n'est pas défini :

Result = GetAttr(FName) And vbArchive

Une valeur différente de zéro est retournée si l'attribut Archive est défini.

Exemple

Cet exemple utilise la fonction GetAttr pour déterminer les attributs d'un fichier et d'un répertoire ou d'un dossier.

Dim MyAttr As FileAttribute
' Assume file TESTFILE is normal and readonly.
MyAttr = GetAttr("C:\TESTFILE.txt")   ' Returns vbNormal.

' Test for normal.
If (MyAttr And FileAttribute.Normal) = FileAttribute.Normal Then
   MsgBox("This file is normal.")
End If

' Test for normal and readonly.
Dim normalReadonly As FileAttribute
normalReadonly = FileAttribute.Normal Or FileAttribute.ReadOnly
If (MyAttr And normalReadonly) = normalReadonly Then
   MsgBox("This file is normal and readonly.")
End If

' Assume MYDIR is a directory or folder.
MyAttr = GetAttr("C:\MYDIR")
If (MyAttr And FileAttribute.Directory) = FileAttribute.Directory Then
   MsgBox("MYDIR is a directory")
End If

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

FileSystem, classe
Membres FileSystem
Microsoft.VisualBasic, espace de noms
IOException Class
FileNotFoundException Class

Autres ressources

GetAttr, fonction
And, opérateur (Visual Basic)
FileAttr, fonction
SetAttr, fonction
FileAttribute, énumération
Propriétés des fichiers, répertoires et lecteurs dans Visual Basic

Partager via