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 текущего объекта 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.

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

- или --or-

Пользователь пытается задать значение атрибута, но не имеет разрешения на запись.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;

Безопасность

FileIOPermission
для записи файлов и каталогов.for writing files and directories. Связанное перечисление: WriteДействие по обеспечению безопасности:DemandAssociated enumeration: Write Security action: Demand

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

Дополнительно