Прочитать на английском

Поделиться через


File.GetAttributes Метод

Определение

Перегрузки

GetAttributes(SafeFileHandle)

Возвращает указанный FileAttributes файл или каталог, связанный с fileHandle.

GetAttributes(String)

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

GetAttributes(SafeFileHandle)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs

Возвращает указанный FileAttributes файл или каталог, связанный с fileHandle.

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

Параметры

fileHandle
SafeFileHandle

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

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

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

Исключения

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

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

Применяется к

GetAttributes(String)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
File.cs

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

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

Параметры

path
String

Путь к файлу.

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

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

Исключения

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

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

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

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

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

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

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

Примеры

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

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;
    }
}

Комментарии

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

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

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

Применяется к