SpecialDirectories Class

.NET Framework (current version)

Other Versions

Provides properties for accessing commonly referenced directories.

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

Inheritance Hierarchy

System::Object
Microsoft.VisualBasic.FileIO::SpecialDirectories

Syntax

C++

[HostProtectionAttribute(SecurityAction::LinkDemand, Resources = HostProtectionResource::ExternalProcessMgmt)]
public ref class SpecialDirectories

Constructors

	Name	Description
	SpecialDirectories()	Returns an instance of the SpecialDirectories class.

Properties

	Name	Description
	AllUsersApplicationData	Gets a path name pointing to the Application Data directory for the all users.
	CurrentUserApplicationData	Gets a path name pointing to the Application Data directory for the current user.
	Desktop	Gets a path name pointing to the Desktop directory.
	MyDocuments	Gets a path name pointing to the My Documents directory.
	MyMusic	Gets a path name pointing to the My Music directory.
	MyPictures	Gets a path name pointing to the My Pictures directory.
	ProgramFiles	Gets a path pointing to the Program Files directory.
	Programs	Gets a path name pointing to the Programs directory.
	Temp	Gets a path name pointing to the Temp directory.

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Remarks

If the path for the referenced directory is empty, usually due to the operating system not supporting the directory, a DirectoryNotFoundException exception is thrown.

No backslash (\) appears at the end of the path.

The following table lists examples of tasks involving the My.Computer.FileSystem.SpecialDirectories object.

To	See
Read from the MyDocuments directory	How to: Retrieve the Contents of the My Documents Directory in Visual Basic

Availability by Project Type

Project type	Available
Windows Application	Yes
Class Library	Yes
Console Application	Yes
Windows Control Library	Yes
Web Control Library	Yes
Windows Service	Yes
Web Site	Yes

Examples

This example returns the filePath for the user's Desktop directory and displays it.

Dim filePath As String
filePath = My.Computer.FileSystem.SpecialDirectories.Desktop
MsgBox(filePath)

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.