This topic has not yet been rated - Rate this topic

FileSystem.SetAttr Method

.NET Framework 4.5

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)

Syntax

C++

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.

Exceptions

Exception	Condition
ArgumentException	PathName invalid or does not exist.
ArgumentException	Attribute type is invalid.

Remarks

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.

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

Examples

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)

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

FileSystem Class

Microsoft.VisualBasic Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)