FileSystemInfo.Attributes Propriété

  • Référence

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Obtient ou définit les attributs pour le fichier ou le répertoire actif.

public:
 property System::IO::FileAttributes Attributes { System::IO::FileAttributes get(); void set(System::IO::FileAttributes value); };
public System.IO.FileAttributes Attributes { get; set; }
member this.Attributes : System.IO.FileAttributes with get, set
Public Property Attributes As FileAttributes

Valeur de propriété

FileAttributes

FileAttributes du FileSystemInfo en cours.

Exceptions

FileNotFoundException

Le fichier spécifié n’existe pas. Levée uniquement pendant la définition de la valeur de propriété.

DirectoryNotFoundException

Le chemin d’accès spécifié n’est pas valide. Par exemple, il est sur un lecteur non mappé. Levée uniquement pendant la définition de la valeur de propriété.

SecurityException

L’appelant n’a pas l’autorisation requise.

UnauthorizedAccessException

.NET Core et .NET 5+ uniquement : l’utilisateur tente de définir une valeur d’attribut, mais n’a pas d’autorisation d’écriture.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

ArgumentException

L’appelant tente de définir un attribut de fichier non valide.

  • ou -

.NET Framework uniquement : L’utilisateur tente de définir une valeur d’attribut mais ne dispose pas de l’autorisation en écriture.

IOException

Refresh() ne peut pas initialiser les données.

Exemples

L’exemple suivant illustre la Attributes propriété. Cet exemple de code fait partie d’un exemple plus grand fourni pour la FileSystemInfo classe.

static void DisplayFileSystemInfoAttributes(FileSystemInfo^ fsi)
{
    //  Assume that this entry is a file.
    String^ entryType = "File";

    // Determine if entry is really a directory
    if ((fsi->Attributes & FileAttributes::Directory) == FileAttributes::Directory)
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console::WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi->FullName, fsi->CreationTime);
}

static void DisplayFileSystemInfoAttributes(FileSystemInfo fsi)
{
    //  Assume that this entry is a file.
    string entryType = "File";

    // Determine if entry is really a directory
    if ((fsi.Attributes & FileAttributes.Directory) == FileAttributes.Directory )
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi.FullName, fsi.CreationTime);
}

Sub DisplayFileSystemInfoAttributes(ByVal fsi As IO.FileSystemInfo)
    ' Assume that this entry is a file.
    Dim entryType As String = "File"

    ' Determine if this entry is really a directory.
    If (fsi.Attributes And FileAttributes.Directory) = FileAttributes.Directory Then
        entryType = "Directory"
    End If

    ' Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", _
        entryType, fsi.FullName, fsi.CreationTime)
End Sub

Remarques

La valeur de la Attributes propriété est pré-mise en cache si l’instance actuelle de l’objet FileSystemInfo a été retournée à partir de l’une des méthodes suivantes DirectoryInfo :

La valeur peut être mise en cache lorsque la valeur elle-même ou d’autres FileSystemInfo propriétés sont accessibles. Pour obtenir la dernière valeur, appelez la Refresh méthode.

Si le chemin d’accès n’existe pas comme dernier état mis en cache, la valeur de retour est (FileAttributes)(-1). FileNotFoundException ou DirectoryNotFoundException peut être levée uniquement lors de la définition de la valeur.

La valeur de cette propriété est une combinaison des indicateurs d’attributs d’attributs de fichier temporaires, masqués, masqués, hors connexion, en lecture seule et temporaires.

Lorsque vous définissez cette valeur, utilisez l’opérateur OR au niveau du bit (| en C# ou Or en Visual Basic) pour appliquer plusieurs valeurs. Pour conserver toutes les valeurs existantes dans la Attributes propriété, incluez la valeur de la Attributes propriété dans votre affectation. Exemple :

exampleFile.Attributes = exampleFile.Attributes | FileAttributes.ReadOnly;

S’applique à

Voir aussi