Export (0) Print
Expand All

FileSystemInfo.Attributes Property

Gets or sets the attributes for the current file or directory.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

public FileAttributes Attributes { get; set; }

Property Value

Type: System.IO.FileAttributes
FileAttributes of the current FileSystemInfo.

ExceptionCondition
FileNotFoundException

The specified file does not exist.

DirectoryNotFoundException

The specified path is invalid; for example, it is on an unmapped drive.

SecurityException

The caller does not have the required permission.

ArgumentException

The caller attempts to set an invalid file attribute.

-or-

The user attempts to set an attribute value but does not have write permission.

IOException

Refresh cannot initialize the data.

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:

To get the latest value, call the Refresh method.

The value of this property is a combination of the archive, compressed, directory, hidden, offline, read-only, system, and temporary file attribute flags.

When you set this value, use the bitwise OR operator (| in C# or Or in Visual Basic) to apply more than one value. 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;

The following example demonstrates the Attributes property. 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);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Show:
© 2015 Microsoft