FileAttributes Enumeração

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Fornece os atributos para arquivos e diretórios.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class FileAttributes

[System.Flags]
public enum FileAttributes

[<System.Flags>]
type FileAttributes = 

Public Enum FileAttributes

Herança

Object

ValueType

Enum

FileAttributes

Atributos

FlagsAttribute

Campos

Archive	32	Esse arquivo está marcado para ser incluído na operação de backup incremental. O Windows define esse atributo sempre que o arquivo é modificado e precisa ser limpo pelo software de backup durante o processamento do arquivo no backup incremental.
Compressed	2048	O arquivo está compactado.
Device	64	Reservado para uso futuro.
Directory	16	O arquivo é um diretório. O Directory é compatível com o Windows, o Linux e o macOS.
Encrypted	16384	O arquivo ou diretório está criptografado. Para um arquivo, isso significa que todos os dados do arquivo são criptografados. Para um diretório, isso significa que a criptografia é o padrão para arquivos e diretórios recém-criados.
Hidden	2	O arquivo está oculto e, portanto, não está incluído em uma listagem de diretório comum. O Hidden é compatível com o Windows, o Linux e o macOS.
IntegrityStream	32768	O arquivo ou diretório inclui suporte à integridade de dados. Quando esse valor é aplicado a um arquivo, todos os fluxos de dados do arquivo têm suporte à integridade. Quando esse valor é aplicado a um diretório, todos os novos arquivos e novas subpastas do diretório, por padrão, incluem suporte à integridade.
None	0
Normal	128	O arquivo é um arquivo padrão que não tem nenhum atributo especial. Esse atributo será válido somente se for usado sozinho. O Normal é compatível com o Windows, o Linux e o macOS.
NoScrubData	131072	O arquivo ou diretório é excluído do exame de integridade de dados. Quando esse valor é aplicado a uma pasta, por padrão, todos os novos arquivos e subdiretórios do diretório são excluídos da integridade de dados.
NotContentIndexed	8192	O arquivo não será indexado pelo serviço de indexação de conteúdo do sistema operacional.
Offline	4096	O arquivo está offline. Os dados do arquivo não estão disponíveis imediatamente.
ReadOnly	1	Ele é somente leitura. O ReadOnly é compatível com o Windows, o Linux e o macOS. No Linux e no macOS, a alteração do sinalizador ReadOnly é uma operação de permissões.
ReparsePoint	1024	O arquivo contém um ponto de nova análise, que é um bloco de dados definidos pelo usuário associado a um arquivo ou diretório. O ReparsePoint é compatível com o Windows, o Linux e o macOS.
SparseFile	512	O arquivo é um arquivo esparso. Em geral, arquivos esparsos são arquivos grandes cujos dados consistem principalmente em zeros.
System	4	O arquivo é um arquivo do sistema. Ou seja, o arquivo faz parte do sistema operacional ou é usado exclusivamente pelo sistema operacional.
Temporary	256	O arquivo é temporário. Um arquivo temporário contém dados necessários durante a execução de um aplicativo, mas que não são necessários após a conclusão do aplicativo. Os sistemas de arquivos tentam manter todos os dados na memória para acesso mais rápido em vez de liberar os dados de volta para o armazenamento em massa. Um arquivo temporário deve ser excluído pelo aplicativo assim que ele não seja mais necessário.

Exemplos

O exemplo a seguir mostra como recuperar os atributos de um arquivo e marcar se o arquivo for somente leitura.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            FileAttributes attributes = File.GetAttributes("c:/Temp/testfile.txt");
            if ((attributes & FileAttributes.ReadOnly) == FileAttributes.ReadOnly)
            {
                Console.WriteLine("read-only file");
            }
            else
            {
                Console.WriteLine("not read-only file");
            }
        }
    }
}

open System.IO

let attributes = File.GetAttributes "c:/Temp/testfile.txt"
if attributes &&& FileAttributes.ReadOnly = FileAttributes.ReadOnly then
    printfn "read-only file"
else
    printfn "not read-only file"

Imports System.IO
Imports System.Text

Module Module1
    Sub Main()
        Dim attributes = File.GetAttributes("c:/Temp/testfile.txt")
        If ((attributes And FileAttributes.ReadOnly) = FileAttributes.ReadOnly) Then
            Console.WriteLine("read-only file")
        Else
            Console.WriteLine("not read-only file")
        End If
    End Sub
End Module

Comentários

Você pode obter atributos para arquivos e diretórios chamando o File.GetAttributes método e pode defini-los chamando o File.SetAttributes método .

Não é possível alterar a compactação status de um File objeto usando o File.SetAttributes método . Em vez disso, você deve realmente compactar o arquivo usando uma ferramenta de compactação ou uma das classes no System.IO.Compression namespace.

Os seguintes atributos não têm suporte do .NET Core no Linux e no macOS:

• FileAttributes.Archive
• FileAttributes.Compressed
• FileAttributes.Device
• FileAttributes.Encrypted
• FileAttributes.IntegrityStream
• FileAttributes.NoScrubData
• FileAttributes.NotContentIndexed
• FileAttributes.Offline
• FileAttributes.SparseFile
• FileAttributes.System
• FileAttributes.Temporary

Em sistemas Unix, o valor retornado por File.GetAttributes inclui Hidden para um arquivo cujo nome começa com um período ("."). No macOS, você pode obter ou definir o sinalizador oculto.

Confira também

• GetAttributes(String)
• SetAttributes(String, FileAttributes)