Partager via


FileSystemInfo.Attributes Propriété

Définition

Obtient ou définit les attributs du fichier ou du 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 de l’actuel FileSystemInfo.

Exceptions

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

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

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

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

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

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 n’a pas d’autorisation d’écriture.

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);
}
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 en tant que 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’archive, compressé, de répertoire, masqué, hors connexion, en lecture seule, système et d’attributs de fichier 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 les valeurs existantes dans la Attributes propriété, incluez la valeur de la Attributes propriété dans votre affectation. Par exemple:

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

S’applique à

Voir aussi