File.GetAttributes Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

GetAttributes(SafeFileHandle)	Возвращает указанный FileAttributes файл или каталог, связанный с fileHandle.
GetAttributes(String)	Получает значение FileAttributes для файла в пути.

GetAttributes(SafeFileHandle)

Исходный код:

File.cs

Возвращает указанный FileAttributes файл или каталог, связанный с 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

Параметры

fileHandle

SafeFileHandle

Объект SafeFileHandle для файла или каталога, для которого необходимо извлечь атрибуты.

Возвращаемое значение

FileAttributes

Объект FileAttributes файла или каталога.

Исключения

ArgumentNullException

fileHandle имеет значение null.

UnauthorizedAccessException

У вызывающего объекта отсутствует необходимое разрешение.

GetAttributes(String)

Исходный код:

File.cs

Получает значение FileAttributes для файла в пути.

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

Параметры

path

String

Путь к файлу.

Возвращаемое значение

FileAttributes

Значение FileAttributes для файла в пути.

Исключения

ArgumentException

платформа .NET Framework и .NET Core более ранних версий, чем 2.1: path пусто, содержит только пробелы или недопустимые символы.

PathTooLongException

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.

NotSupportedException

Параметр path задан в недопустимом формате.

FileNotFoundException

path представляет файл и является недопустимым, например указывает на несопоставленный диск, или же невозможно найти файл.

DirectoryNotFoundException

path представляет каталог и является недопустимым, например указывает на несопоставленный диск, или же невозможно найти каталог.

IOException

Этот файл используется другим процессом.

UnauthorizedAccessException

У вызывающего объекта отсутствует необходимое разрешение.

Примеры

В следующем примере демонстрируются GetAttributes методы и SetAttributes путем применения атрибутов Archive и Hidden к файлу.

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

Комментарии

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные относительно текущего рабочего каталога. Сведения о том, как получить текущий рабочий каталог, см. в разделе GetCurrentDirectory.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Чтение текста из файла
• Практическое руководство. Запись текста в файл