File.SetAttributes Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Surcharges

SetAttributes(SafeFileHandle, FileAttributes)	Définit le spécifié FileAttributes du fichier ou du répertoire associé fileHandleà .
SetAttributes(String, FileAttributes)	Définit l'élément FileAttributes spécifié du fichier sur le chemin d'accès spécifié.

SetAttributes(SafeFileHandle, FileAttributes)

Source:

File.cs

Définit le spécifié FileAttributes du fichier ou du répertoire associé fileHandleà .

public:
 static void SetAttributes(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, System::IO::FileAttributes fileAttributes);

public static void SetAttributes (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, System.IO.FileAttributes fileAttributes);

static member SetAttributes : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAttributes -> unit

Public Shared Sub SetAttributes (fileHandle As SafeFileHandle, fileAttributes As FileAttributes)

Paramètres

fileHandle

SafeFileHandle

SafeFileHandle dans le fichier ou le répertoire pour lequel fileAttributes doit être défini.

fileAttributes

FileAttributes

Combinaison d'opérations de bits des valeurs d'énumération.

Exceptions

ArgumentNullException

fileHandle a la valeur null.

UnauthorizedAccessException

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

Remarques

Il n’est pas possible de modifier la status de compression d’un File objet à l’aide de la SetAttributes(SafeFileHandle, FileAttributes) méthode .

SetAttributes(String, FileAttributes)

Source:

File.cs

Définit l'élément FileAttributes spécifié du fichier sur le chemin d'accès spécifié.

public:
 static void SetAttributes(System::String ^ path, System::IO::FileAttributes fileAttributes);

public static void SetAttributes (string path, System.IO.FileAttributes fileAttributes);

static member SetAttributes : string * System.IO.FileAttributes -> unit

Public Shared Sub SetAttributes (path As String, fileAttributes As FileAttributes)

Paramètres

path

String

Chemin d'accès au fichier.

fileAttributes

FileAttributes

Combinaison d'opérations de bits des valeurs d'énumération.

Exceptions

ArgumentException

.NET Framework et .NET Core versions antérieures à 2.1 : path est vide, contient uniquement des espaces blancs, contient des caractères non valides ou l’attribut de fichier n’est pas valide.

PathTooLongException

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

NotSupportedException

path est dans un format non valide.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

FileNotFoundException

Fichier introuvable.

UnauthorizedAccessException

path a spécifié un fichier en lecture seule.

- ou -

Cette opération n'est pas prise en charge sur la plateforme actuelle.

- ou -

path a spécifié un répertoire.

- ou -

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

Exemples

L’exemple suivant illustre les GetAttributes méthodes et SetAttributes en appliquant les Archive attributs et Hidden à un fichier.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file if it does not exist.
   if (  !File::Exists( path ) )
   {
      File::Create( path );
   }

   if ( (File::GetAttributes( path ) & FileAttributes::Hidden) == FileAttributes::Hidden )
   {
      
      // Show the file.
      File::SetAttributes(path, File::GetAttributes( path ) & ~FileAttributes::Hidden);
      Console::WriteLine( "The {0} file is no longer hidden.", path );
   }
   else
   {
      
      // Hide the file.
      File::SetAttributes( path, static_cast<FileAttributes>(File::GetAttributes( path ) | FileAttributes::Hidden) );
      Console::WriteLine( "The {0} file is now hidden.", path );
   }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file if it does not exist.
        if (!File.Exists(path))
        {
            File.Create(path);
        }

        FileAttributes attributes = File.GetAttributes(path);

        if ((attributes & FileAttributes.Hidden) == FileAttributes.Hidden)
        {
            // Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden);
            File.SetAttributes(path, attributes);
            Console.WriteLine("The {0} file is no longer hidden.", path);
        }
        else
        {
            // Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) | FileAttributes.Hidden);
            Console.WriteLine("The {0} file is now hidden.", path);
        }
    }

    private static FileAttributes RemoveAttribute(FileAttributes attributes, FileAttributes attributesToRemove)
    {
        return attributes & ~attributesToRemove;
    }
}

open System.IO
open System.Text

let removeAttribute attributes attributesToRemove = attributes &&& ~~~attributesToRemove

let path = @"c:\temp\MyTest.txt"

// Create the file if it does not exist.
if File.Exists path |> not then
    File.Create path |> ignore

let attributes = File.GetAttributes path

if attributes &&& FileAttributes.Hidden = FileAttributes.Hidden then
    // Show the file.
    let attributes =
        removeAttribute attributes FileAttributes.Hidden

    File.SetAttributes(path, attributes)
    printfn $"The {path} file is no longer hidden."
else
    // Hide the file.
    File.SetAttributes(path, File.GetAttributes path ||| FileAttributes.Hidden)
    printfn $"The {path} file is now hidden."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Create the file if it does not exist.
        If File.Exists(path) = False Then
            File.Create(path)
        End If

        Dim attributes As FileAttributes
        attributes = File.GetAttributes(path)

        If (attributes And FileAttributes.Hidden) = FileAttributes.Hidden Then
            ' Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden)
            File.SetAttributes(path, attributes)
            Console.WriteLine("The {0} file is no longer hidden.", path)
        Else
            ' Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) Or FileAttributes.Hidden)
            Console.WriteLine("The {0} file is now hidden.", path)
        End If
    End Sub

    Public Shared Function RemoveAttribute(ByVal attributes As FileAttributes, ByVal attributesToRemove As FileAttributes) As FileAttributes
        Return attributes And (Not attributesToRemove)
    End Function
End Class

Remarques

Le path paramètre est autorisé à spécifier des informations relatives ou absolues sur le chemin d’accès. Les informations relatives au chemin d’accès sont interprétées comme relatives au répertoire de travail actuel. Pour obtenir le répertoire de travail actuel, consultez GetCurrentDirectory.

Certains attributs de fichier, tels que Hidden et ReadOnly, peuvent être combinés. D’autres attributs, tels que Normal, doivent être utilisés seuls.

Il n’est pas possible de modifier la status de compression d’un File objet à l’aide de la SetAttributes méthode .

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

• FileSystemWatcher
• Fichier et flux de données E/S
• Lecture de texte à partir d’un fichier
• Procédure : écrire du texte dans un fichier