FileSystemInfo.Attributes Свойство

Определение

Получает или задает атрибуты для текущего файла или каталога.Gets or sets the attributes for the current file or directory.

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, set
Public Property Attributes As FileAttributes

Значение свойства

FileAttributes

Атрибуты FileAttributes текущего объекта FileSystemInfo.FileAttributes of the current FileSystemInfo.

Исключения

Указанный файл не существует.The specified file doesn't exist. Возникает только при установке значения свойства.Only thrown when setting the property value.

Указан недопустимый путь.The specified path is invalid. Например, он ведет на несопоставленный диск.For example, it's on an unmapped drive. Возникает только при установке значения свойства.Only thrown when setting the property value.

У вызывающего объекта отсутствует необходимое разрешение.The caller doesn't have the required permission.

Только в .NET Core: Пользователь пытается задать значение атрибута, но не имеет разрешения на запись..NET Core only: The user attempts to set an attribute value but doesn't have write permission.

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.The specified path, file name, or both exceed the system-defined maximum length.

Вызывающий оператор пытается установить недействительный атрибут файла.The caller attempts to set an invalid file attribute.

- или --or-

Только .NET Framework: Пользователь пытается задать значение атрибута, но не имеет разрешения на запись..NET Framework only: The user attempts to set an attribute value but doesn't have write permission.

Refresh() не может инициализировать данные.Refresh() cannot initialize the data.

Примеры

В следующем примере демонстрируется Attributes свойство.The following example demonstrates the Attributes property. Этот пример кода является частью большого примера, приведенного для FileSystemInfo класса.This code example is part of a larger example provided for the FileSystemInfo class.

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

Комментарии

Значение Attributes Свойства предварительно кэшируется, если текущий экземпляр FileSystemInfo объекта был возвращен из любого из следующих DirectoryInfo методов:The value of the Attributes property is pre-cached if the current instance of the FileSystemInfo object was returned from any of the following DirectoryInfo methods:

Значение может быть кэшировано при доступе к значению или другим FileSystemInfo свойствам.The value may be cached when either the value itself or other FileSystemInfo properties are accessed. Чтобы получить Последнее значение, вызовите Refresh метод.To get the latest value, call the Refresh method.

Если путь не существует по состоянию последнего кэширования, возвращается значение (FileAttributes)(-1) .If the path doesn't exist as of the last cached state, the return value is (FileAttributes)(-1). FileNotFoundException или DirectoryNotFoundException может быть вызван только при задании значения.FileNotFoundException or DirectoryNotFoundException can only be thrown when setting the value.

Значение этого свойства представляет собой сочетание флагов архива, сжатого, каталога, скрытого, автономного, доступного только для чтения, системного и временного файлов.The value of this property is a combination of the archive, compressed, directory, hidden, offline, read-only, system, and temporary file attribute flags.

При задании этого значения используйте оператор побитового или ( | в C# или Or в Visual Basic), чтобы применить более одного значения.When you set this value, use the bitwise OR operator (| in C# or Or in Visual Basic) to apply more than one value. Чтобы хранить все существующие значения в Attributes свойстве, включите значение Attributes свойства в назначение.To retain any existing values in the Attributes property, include the value of the Attributes property in your assignment. Пример:For example:

exampleFile.Attributes = exampleFile.Attributes | FileAttributes.ReadOnly;

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

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