File.GetAttributes Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.Runtime.dll

Ensamblados:: mscorlib.dll, System.IO.FileSystem.dll

Ensamblado:: System.IO.FileSystem.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

GetAttributes(SafeFileHandle)	Obtiene el objeto especificado FileAttributes del archivo o directorio asociado a `fileHandle`.
GetAttributes(String)	Obtiene el FileAttributes del archivo en la ruta de acceso.

GetAttributes(SafeFileHandle)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Obtiene el objeto especificado FileAttributes del archivo o directorio asociado a fileHandle.

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

al SafeFileHandle archivo o directorio para el que se van a recuperar los atributos.

Devoluciones

FileAttributes

del FileAttributes archivo o directorio.

Excepciones

ArgumentNullException

fileHandle es null.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	7, 8, 9

GetAttributes(String)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Obtiene el FileAttributes del archivo en la ruta de acceso.

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

Ruta de acceso al archivo.

Devoluciones

FileAttributes

FileAttributes del archivo en la ruta de acceso.

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a la 2.1: path está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

NotSupportedException

path está en un formato no válido.

FileNotFoundException

path representa un archivo y no es válido, por ejemplo, se encuentra en una unidad no asignada o el archivo no se encuentra.

DirectoryNotFoundException

path representa un directorio y no es válido, por ejemplo, se encuentra en una unidad no asignada o el directorio no se encuentra.

IOException

Otro proceso está usando este archivo.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

Ejemplos

En el ejemplo siguiente se muestran los GetAttributes métodos y aplicando los Archive atributos y SetAttributesHidden a un archivo .

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

Comentarios

El path parámetro puede especificar información de ruta de acceso relativa o absoluta. La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Para obtener una lista de las tareas de E/S comunes, consulte Tareas de E/S comunes.

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Compartir a través de

File.GetAttributes Método

Definición

Sobrecargas

GetAttributes(SafeFileHandle)

Parámetros

Devoluciones

Excepciones

Se aplica a

GetAttributes(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales