Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Attributes Property

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

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Show:
© 2015 Microsoft