FileSystemInfo.Attributes Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define os atributos do ficheiro ou diretório atual.
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, setPublic Property Attributes As FileAttributesValor de Propriedade
FileAttributes do atual FileSystemInfo.
Exceções
O ficheiro especificado não existe. Só é lançado ao definir o valor da propriedade.
O caminho especificado é inválido. Por exemplo, está num disco não mapeado. Só é lançado ao definir o valor da propriedade.
O chamador não tem a permissão necessária.
.NET Core e .NET 5+ apenas: O utilizador tenta definir um valor de atributo mas não tem permissão de escrita.
O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.
O chamador tenta definir um atributo de ficheiro inválido.
-ou-
Framework .NET apenas: O utilizador tenta definir um valor de atributo mas não tem permissão de escrita.
Refresh() não é possível inicializar os dados.
Exemplos
O exemplo seguinte demonstra a Attributes propriedade. Este exemplo de código faz parte de um exemplo maior fornecido para a FileSystemInfo classe.
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
Observações
O valor da Attributes propriedade é pré-cacheado se a instância atual do FileSystemInfo objeto foi devolvida de qualquer um dos seguintes DirectoryInfo métodos:
O valor pode ser armazenado em cache quando o valor em si ou outras FileSystemInfo propriedades são acedidas. Para obter o valor mais recente, ligue para o Refresh método.
Se o caminho não existir no último estado em cache, o valor de retorno é (FileAttributes)(-1).
FileNotFoundException ou DirectoryNotFoundException só pode ser lançado ao definir o valor.
O valor desta propriedade é uma combinação das flags de arquivo, comprimido, diretório, oculto, offline, apenas leitura, sistema e atributos temporários de ficheiro.
Ao definir este valor, use o operador OR bit a bit (| em C# ou Or em Visual Basic) para aplicar mais do que um valor. Para manter quaisquer valores existentes na Attributes propriedade, inclua o valor da Attributes propriedade na sua cessão. Por exemplo:
exampleFile.Attributes = exampleFile.Attributes | FileAttributes.ReadOnly;