File.SetAttributes Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

SetAttributes(SafeFileHandle, FileAttributes)	Define o especificado FileAttributes do arquivo ou diretório associado fileHandlea .
SetAttributes(String, FileAttributes)	Define o FileAttributes especificado do arquivo no caminho especificado.

SetAttributes(SafeFileHandle, FileAttributes)

Origem:

File.cs

Define o especificado FileAttributes do arquivo ou diretório associado fileHandlea .

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)

Parâmetros

fileHandle

SafeFileHandle

Um SafeFileHandle para o arquivo ou diretório para o qual fileAttributes deve ser definido.

fileAttributes

FileAttributes

Um combinação bit a bit dos valores de enumeração.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

O chamador não tem a permissão necessária.

Comentários

Não é possível alterar a compactação status de um File objeto usando o SetAttributes(SafeFileHandle, FileAttributes) método .

SetAttributes(String, FileAttributes)

Origem:

File.cs

Define o FileAttributes especificado do arquivo no caminho especificado.

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)

Parâmetros

path

String

O caminho para o arquivo.

fileAttributes

FileAttributes

Um combinação bit a bit dos valores de enumeração.

Exceções

ArgumentException

.NET Framework e versões do .NET Core anteriores à 2.1: path está vazio, contém apenas espaços em branco, contém caracteres inválidos ou o atributo de arquivo é inválido.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

NotSupportedException

path está em um formato inválido.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

FileNotFoundException

Não é possível encontrar o arquivo.

UnauthorizedAccessException

path especificou um arquivo somente leitura.

- ou -

Não há suporte para essa operação na plataforma atual.

- ou -

path especificou um diretório.

- ou -

O chamador não tem a permissão necessária.

Exemplos

O exemplo a seguir demonstra os GetAttributes métodos e SetAttributes aplicando os Archive atributos e Hidden a um arquivo .

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

Comentários

O path parâmetro tem permissão para especificar informações de caminho relativas ou absolutas. As informações do caminho relativo são interpretadas como relativas ao diretório de trabalho atual. Para obter o diretório de trabalho atual, consulte GetCurrentDirectory.

Determinados atributos de arquivo, como Hidden e ReadOnly, podem ser combinados. Outros atributos, como Normal, devem ser usados sozinhos.

Não é possível alterar a compactação status de um File objeto usando o SetAttributes método .

Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.

Confira também

• FileSystemWatcher
• E/S de arquivo e de fluxo
• Lendo texto de um arquivo
• Como gravar texto em um arquivo