FileSystem.SetAttr Method (String, FileAttribute)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Sets attribute information for a file. The My feature gives you better productivity and performance in file I/O operations than SetAttr. For more information, see FileSystem.

Namespace:   Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public static void SetAttr(
	string PathName,
	FileAttribute Attributes
)

Parameters

PathName
Type: System.String

Required. String expression that specifies a file name. PathName can include directory or folder, and drive.

Attributes
Type: Microsoft.VisualBasic.FileAttribute

Required. Constant or numeric expression, whose sum specifies file attributes.

Exception Condition
ArgumentException

PathName invalid or does not exist.

ArgumentException

Attribute type is invalid.

A run-time error occurs if you try to set the attributes of an open file.

The Attributes argument enumeration values are as follows:

Value

Constant

Description

Normal

vbNormal

Normal (default).

ReadOnly

vbReadOnly

Read-only.

Hidden

vbHidden

Hidden.

System

vbSystem

System file.

Volume

vbVolume

Volume label

Directory

vbDirectory

Directory or folder.

Archive

vbArchive

File has changed since last backup.

Alias

vbAlias

File has a different name.

System_CAPS_noteNote

These enumerations are specified by the Visual Basic language. The names can be used anywhere in your code instead of the actual values.

This example uses the SetAttr function to set attributes for a file.

' Set hidden attribute.
SetAttr("TESTFILE", vbHidden)
' Set hidden and read-only attributes.
SetAttr("TESTFILE", vbHidden Or vbReadOnly)

.NET Framework
Available since 1.1
Return to top
Show: