FileSystemInfo.Attributes Propriété

Définition

Obtient ou définit les attributs pour le fichier ou le répertoire actif.Gets or sets the attributes for the current file or directory.

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.FileAttributes of the current FileSystemInfo.

Exceptions

Le fichier spécifié n’existe pas.The specified file doesn't exist. Levée uniquement pendant la définition de la valeur de propriété.Only thrown when setting the property value.

Le chemin d’accès spécifié n’est pas valide.The specified path is invalid. Par exemple, il est sur un lecteur non mappé.For example, it's on an unmapped drive. Levée uniquement pendant la définition de la valeur de propriété.Only thrown when setting the property value.

L’appelant n’a pas l’autorisation requise.The caller doesn't have the required permission.

.NET Core uniquement : L’utilisateur tente de définir une valeur d’attribut mais ne dispose pas de l’autorisation en écriture..NET Core only: The user attempts to set an attribute value but doesn't have write permission.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

L’appelant tente de définir un attribut de fichier non valide.The caller attempts to set an invalid file attribute.

- ou --or-

.NET Framework uniquement : L’utilisateur tente de définir une valeur d’attribut mais ne dispose pas de l’autorisation en écriture..NET Framework only: The user attempts to set an attribute value but doesn't have write permission.

Refresh() ne peut pas initialiser les données.Refresh() cannot initialize the data.

Exemples

L’exemple suivant illustre la Attributes propriété.The following example demonstrates the Attributes property. Cet exemple de code fait partie d’un exemple plus complet fourni pour la FileSystemInfo classe.This code example is part of a larger example provided for the FileSystemInfo class.

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 mise en cache préalablement si l’instance actuelle de l' FileSystemInfo objet a été retournée à partir de l’une des DirectoryInfo méthodes suivantes :The value of the Attributes property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following DirectoryInfo methods:

La valeur peut être mise en cache lorsque la valeur elle-même ou d’autres FileSystemInfo propriétés sont accessibles.The value may be cached when either the value itself or other FileSystemInfo properties are accessed. Pour récupérer la valeur la plus récente, appelez la Refresh méthode.To get the latest value, call the Refresh method.

Si le chemin d’accès n’existe pas dans le dernier État mis en cache, la valeur de retour est (FileAttributes)(-1) .If the path doesn't exist as of the last cached state, the return value is (FileAttributes)(-1). FileNotFoundException ou DirectoryNotFoundException ne peut être levée que lors de la définition de la valeur.FileNotFoundException or DirectoryNotFoundException can only be thrown when setting the value.

La valeur de cette propriété est une combinaison des indicateurs d’attribut d’archive, de compression, de répertoire, masqué, hors connexion, en lecture seule, système et de fichier temporaire.The value of this property is a combination of the archive, compressed, directory, hidden, offline, read-only, system, and temporary file attribute flags.

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.When you set this value, use the bitwise OR operator (| in C# or Or in Visual Basic) to apply more than one value. Pour conserver les valeurs existantes dans la Attributes propriété, incluez la valeur de la Attributes propriété dans votre assignation.To retain any existing values in the Attributes property, include the value of the Attributes property in your assignment. Exemple :For example:

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

S’applique à

Voir aussi