File.GetAttributes Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

GetAttributes(SafeFileHandle)	Obtém o especificado FileAttributes do arquivo ou diretório associado fileHandlea .
GetAttributes(String)	Obtém o FileAttributes do arquivo no caminho.

GetAttributes(SafeFileHandle)

Origem:

File.cs

Obtém o especificado FileAttributes do arquivo ou diretório associado fileHandlea .

public:
 static System::IO::FileAttributes GetAttributes(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static System.IO.FileAttributes GetAttributes (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetAttributes : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.FileAttributes

Public Shared Function GetAttributes (fileHandle As SafeFileHandle) As FileAttributes

Parâmetros

fileHandle

SafeFileHandle

Um SafeFileHandle para o arquivo ou diretório para o qual os atributos devem ser recuperados.

Retornos

FileAttributes

O FileAttributes do arquivo ou diretório.

Exceções

ArgumentNullException

fileHandle é null.

UnauthorizedAccessException

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

GetAttributes(String)

Origem:

File.cs

Obtém o FileAttributes do arquivo no caminho.

public:
 static System::IO::FileAttributes GetAttributes(System::String ^ path);

public static System.IO.FileAttributes GetAttributes (string path);

static member GetAttributes : string -> System.IO.FileAttributes

Public Shared Function GetAttributes (path As String) As FileAttributes

Parâmetros

path

String

O caminho para o arquivo.

Retornos

FileAttributes

O FileAttributes do arquivo no caminho.

Exceções

ArgumentException

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

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.

FileNotFoundException

path representa um arquivo e é inválido (por exemplo, está em uma unidade não mapeada) ou o arquivo não pode ser encontrado.

DirectoryNotFoundException

path representa um diretório e é inválido (por exemplo, está em uma unidade não mapeada) ou o diretório não pode ser encontrado.

IOException

O arquivo está sendo usado por outro processo.

UnauthorizedAccessException

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.

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

Confira também

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