FileSystemInfo.Attributes Property

 

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

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

Public Property Attributes As FileAttributes

Property Value

Type: System.IO.FileAttributes

FileAttributes of the current FileSystemInfo.

Exception Condition
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.

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

FileIOPermission

for writing files and directories. Associated enumeration: FileIOPermissionAccess.Write Security action: Demand

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: